PrometheusSatyen / Cerebral

Character Manager for EVE Online
GNU Affero General Public License v3.0
68 stars 25 forks source link
ccp eve eve-online

Cerebral

version appveyor build status license: AGPL v3

Cerebral is a tool for monitoring your EVE Online characters. It is focused on ease of use and speed for people who manage larger numbers of characters.

If you enjoy using Cerebral, please consider an ISK donation to the in-game character "Prometheus Satyen". Donations mean I have to spend less time ratting and can spend more time developing!

Cerebral is currently in beta testing. That means there may be bugs in Cerebral. It won't delete your boot.ini but it might lose your tokens, crash, freeze up, etc.

Current Functionality:

Planned Functionality:

Screenshots:

character overview

sp-farming

contracts

character-summary

character-skills

character-plans

character-mails

character-mail

character-api

Installation Instructions:

  1. Download the latest release setup file from the Releases page.
  2. Double click and wait for it to install. This may take 2-3 minutes. Be patient.
    Note: Windows SmartScreen might block the install, just click More Info --> Run anyway.
  3. Once installation is complete Cerebral will launch and you can start using it. A Start Menu/Desktop shortcut will be created automatically.

Update Instructions:

Simply follow the installation instructions and install the new version on top of the old version.

Automatic updates will be available soon.

Usage:

FAQ:

Where are my tokens stored?

Your tokens are stored in your user account folder in /AppData/Roaming/Cerebral/authorized-characters.json. You can back this file up after adding your characters and restore it if needed. Do not allow this file to fall into malicious hands as the contents allow anyone to query your data from CCP.

The application only communicates with the CCP servers, no token data will ever leave your machine for any other destination.

Why is there no Alpha/Omega icon next to my character?

CCP does not allow us to see Alpha/Omega status directly in the API. Instead I perform a number of checks to try to guess whether a character is Alpha/Omega. If there's no icon displayed that means the application could not determine the character's status.

My Anti-Virus/Windows/etc. thinks that this is a virus, what's going on?

Most reputable software is signed using a special signature. To get one of those signatures, you have to pay a fee and your real name goes into the software.

I have no desire to embed my real name into an application I'm distributing to the EVE community, so it's unlikely I will ever be signing my code. As a result many AntiVirus programs will flag the application as a virus, you can safely add an exception if you trust me. :)

Why does Cerebral use an embedded browser for authorization, isn't using the user's native browser more secure?

In some ways yes using the native browser can be considered more secure as it provides additional peace of mind to users that their credentials are not being intercepted by the application.

In my opinion, this benefit is completely overshadowed by the huge improvement in user experience for adding large numbers of characters that the embedded flow provides. This combined with the fact that Cerebral is completely open source allowing you to easily verify that it is not intercepting your credentials led me to choose an embedded authorization flow.

If I have some spare time and feel like it, I may implement a setting allowing paranoid/conspiracy-subscribing users to utilize their own browser for the authorization.

What languages/technologies does Cerebral use?

Node.js using Electron to allow it to run as a native application. (Same as Discord, Slack, etc.)
The UI is powered by React.js.