evebuddy

command module
v0.76.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 13, 2026 License: MIT Imports: 47 Imported by: 0

README

EVE Buddy

A multi-platform companion app for EVE Online players available on Windows, Linux, macOS and Android.

GitHub Release Fyne build status codecov GitHub License chat GitHub Downloads

download

Contents

Description

EVE Buddy is a multi-platform companion app for EVE Online players. It provides the following key features:

  • Character monitor: Check current information about each of your characters, e.g. inspect the training queue of a character or browse its assets. Export trained skills to clipboard in PyFA-compatible format or to a CSV file.
  • Corporation monitor: Check current information about each of your corporations: e.g. check wallets and assets.
  • Overviews: Keep track of and get unique insights about all your characters and corporations with consolidated views, e.g. find assets across all of your characters or see which character has manufacturing slots available.
  • Notifications: Get notified on your desktop or mobile about new EVE communications and other important updates, e.g. a structure was attacked or a training queue became empty.
  • New Eden search: Search live on the game server, similar to in-game search bar, e.g. search for characters, corporations solar systems.
  • Information windows: Show additional information for most objects on screen, similar to in-game information windows, e.g. sender of a mail:
  • Mail client: Send and receive EVE mails for all your characters
  • Run in Background: The app can run in the background and continue to notify you while you are doing something else, e.g. play Eve Online
  • Customizable UI: UI can be customized, e.g. dark and light color theme

EVE Buddy is available for Windows, Linux, macOS and Android.

[!NOTE] Featured in EVE Online's Official Community Beat!
We're proud to have been featured in EVE Online's official Community Beat newsletter:

[!NOTE] Feedback & Support

We’d love to hear from you! If you run into bugs or have questions, feel free to open an issue or drop by the #evebuddy channel on our Discord.

Missing a feature? Open a feature request—we're actively building and improving EVE Buddy every day!

[!TIP] Contribute & Get Involved

We welcome all contributions! Whether you want to fix a bug, add a feature, or improve documentation, feel free to open a Pull Request. Have questions or want to discuss an idea first? Join our community on Discord.

Screenshots

Below are example screenshots for both the desktop and mobile version (EVE Buddy v0.53).

Desktop version
Image
Mobile version
mobile_screenshot

Features

The following is a detailed list of EVE Buddy's features. Most features are available for both desktop and mobile:

  • Overviews: Keep track of and get unique insights about all your characters and corporations with consolidated views:

    • Assets: Search assets across all characters, and export items to clipboard (e.g. for Janice) or CSV
    • Clones: Overview of all current clones and search nearest available jump clones across all characters
    • Colonies: Browse PI colonies across all characters with a forecast of when each colony stops working (up to 30 days ahead), and see which colonies need attention at a glance. Filter by status, owner, planet type, products, location and tags
    • Communications: A unified communications browser for all characters
    • Contracts: Browse contracts of all characters
    • Industry: Browse industry jobs for all characters and related corporations
    • Location: Browse the location of all characters and their current ships
    • Mails: A unified mails browser for all characters
    • Skills: Keep track of the training status for all characters, search for skills across all characters and export training status to clipboard or file
    • Structures: Unified view of all corporation structures across all your corporations, with filtering by owner, system, region, type, state and services
    • Wealth: Charts showing wealth distribution across all characters

  • Character monitor: Check current information about each of your characters:

    • Assets: Browse through your assets at all your locations
    • Clones: Current augmentations, jump clones & jump cooldown timer
    • Communications: Browse through all communications
    • Mails: Browse through all mails
    • Skills: Training queue, catalogue of all trained skills and what ships can be flown, and export trained skills to clipboard (PyFA-compatible format) or CSV
    • Wallet: Wallet and market Transactions

  • Corporation monitor: Check current information about each of your corporations: (depending on their roles)

    • Assets: Browse and search corporation assets, and export items to clipboard or CSV
    • Industry: See running and historic indy jobs
    • Members: List of current corporation members
    • Structures: List of all corporation structures with current fuel status, state and potential timers
    • Wallets: Wallet, market transactions and balances for corporation wallets
    • Wealth: Charts showing wealth distribution for the corporation

  • Notifications: Get notified on your desktop or mobile about new EVE communications and other important updates:

    • Training queue became empty
    • Contract status changed
    • PI colony stopped working
    • New EVE communication received (e.g. structure attacked)
    • New EVE mail received

  • New Eden search: Search live on the game server, similar to in-game search bar:

    • Search for: Agents, Alliances, Characters, Constellations, Corporations, Factions, Regions, Stations, Systems, Types
    • Simple or advanced search with filters
    • Search history

  • Information windows: Show additional information for most objects on screen, similar to in-game information windows:

    • Alliances
    • Characters
    • Constellations
    • Corporations
    • Factions
    • Locations (i.e. structure or station)
    • Regions
    • Systems
    • Types

  • Colony details: Inspect each of your PI colonies in detail:

    • Status, extracted and produced goods and when the colony stops working
    • All installations with their current state, progress and storage fill level
    • Installation pages with contents, incoming and outgoing routes, and predicted extractor output

  • Mail client: Full mail client for receiving and sending EVE mails

  • Run in Background: The app can run in the background and continue to notify you while you are doing something else (e.g. play Eve Online)

    • Desktop: Can minimize to system tray and show an indicator for new EVE mail
    • Mobile: Will continue running in the background after switching to another app

  • Customizable UI: The UI can be customized:

    • Color theme: Dark or Light theme
    • UI scaling: Custom scaling of the whole UI (desktop only)

Installing

To install EVE Buddy just download the latest release from the releases page to your computer or mobile. The app ships as a single executable file that can be run directly. When you run the app for the first time it will automatically install itself for the current user (i.e. by creating folders in the home folder for the current user).

You find the latest packages for download on the releases page.

Windows
  1. Download the windows zip file from the latest release on Github.
  2. Unzip the file into a directory of your choice and run the .exe file to start the app.

[!TIP] Windows defender (and similar programs) may report EVE Buddy incorrectly as containing a trojan. This is usually a false positive and caused by a known issue with programs made with the Go programming language. Each EVE Buddy release is built from scratch on a fresh Windows container provided by Github, so it is highly unlikely to be infected. If this happens to you, please exclude EVE Buddy's executable from Windows defender (and similar programs) to proceed.

macOS
  1. Download the darwin zip file from the latest release on Github for your respective platform (arm or intel).
  2. Unzip the file into a directory of your choice.
  3. Run the .app file to start the app.

[!TIP] MacOS may report EVE Buddy incorrectly as "damaged", because it is not signed with an Apple certificate. You can remove this error by opening a terminal and running the following command. For more information please see Fyne Troubleshooting:

sudo xattr -r -d com.apple.quarantine "EVE Buddy.app"

Linux

We are providing two variants for installing on Linux desktop:

  • AppImage: The AppImage variant allows you to run the app directly from the executable without requiring installation or root access.
  • Tarball: The tar file requires installation, but also allows you to integrate the app into your desktop environment. The tarball also has wider compatibility among different Linux versions.
AppImage

[!NOTE] The app is shipped in the AppImage format, so it can be used without requiring installation and run on many different Linux distributions.

  1. Download the latest AppImage file from the releases page
  2. Make the AppImage file executable
  3. Execute the AppImage file to start the app

[!TIP] Should you get the following error: AppImages require FUSE to run., you need to first install FUSE on your system. This library is required by all AppImages to function. Please see this page for details.

Tarball
  1. Download the latest tar file from the releases page
  2. Decompress the tar file, for example with: tar xf evebuddy-0.33.0-linux-amd64.tar.xz
  3. Run make user-install to install the app for the current user or run sudo make install to install the app on the system

You should now have a shortcut in your desktop environment's launcher for starting the app.

To uninstall the app again run either: make user-uninstall or sudo make uninstall depending on how you installed it.

Android

[!NOTE] Please note that the app can currently be only installed from the release page and is currently not available in any of the Android app stores.

[!IMPORTANT] EVE Buddy needs unrestricted background usage in order to function properly. The reason is that Android otherwise automatically suspends apps when you switch to another app. Then you can no longer add new characters, because it requires you to switch to your browser app, but EVE Buddy needs to keep running for the process to work. Also EVE Buddy needs to keep running in order to pick up events for notifications.

Please also make sure you do not have Power saving mode enabled (e.g. on Samsung Galaxy), which would also restrict background app usage.

Here is how to install EVE Buddy on your Android phone:

  1. Make sure you have enabled in settings that you can install from your web browser (For detailed instructions please see How to install Unknown Sources applications in Android)
  2. Navigate to the github releases page in your mobile browser
  3. Select to download the latest EVE_Buddy.apk file from the release page (this can take a minute)
  4. When prompted choose to install the file / open the file with the default installer
  5. In case you get a security warning from Google Play Protect:
    1. Select "More details"
    2. Select "Install anyway"
  6. Enable unrestricted background usage for EVE Buddy in the Android Settings app. Please see How to enable unrestricted background usage for a step-by-step guide.
  7. Optional: Enable notifications for EVE Buddy. Please see How to enable notifications for a step-by-step guide.
How to enable notifications

Here is how to enable notifications for EVE Buddy on your Android phone:

  1. Go to settings and enable what kind of notifications you want to receive (e.g. mails)
  2. Send a test notification (via menu in settings)
  3. When asked: Allow EVE buddy to send Android notifications

You should now see a test notification.

How to enable unrestricted background usage

Here is how to enable unrestricted background usage for EVE Buddy on your Android phone:

  1. Open the Settings app.

  2. Go to Apps and choose EVE Buddy. You should now see a screen like this: evebuddy_settings_1

  3. Choose "App battery usage". You should now see a screen like this: evebuddy_settings_2

  4. Click on "Allow background usage". You should now see a screen like this: evebuddy_settings_3

  5. Make sure the "Unrestricted" option is selected. That's it.

Updating

The app will inform you when there is a new version available for download. To update your app just download and install the newest version for your platform from the releases page.

Uninstalling

If you no longer want to use the app you can uninstall it.

Windows, Linux and macOS

The desktop versions have a special app for removing our data:

First start the delete app for removing your user data:

./evebuddy --delete-data

This command will ask for confirmation and then delete user data from your computer like characters, log files, etc.

Then delete the file itself:

rm evebuddy
Android

On Android you can uninstall the app via the system's Settings app. This will also remove all data.

Support

[!IMPORTANT] For bugs and feature requests please open an issue in the GitHub repository.

[!TIP] For support and any other questions please join us on in our channel #eve-buddy on this Discord server.

Common issues

The following is an overview of common issues with solutions:

Android
Windows
Logs

The app has an application log and a crash file that can help with trouble shooting. The location of the logs follows the standard of each platform:

Platform Path
Android Export only
Linux /home/{username}/.local/share/evebuddy/log
macOS /Users/{username}/Library/Application Support/evebuddy/log
Windows C:\Users\{username}\AppData\Local\evebuddy\evebuddy\log

On desktop you can view the location of your log files on the User Data dialog, which you find in the main menu.

On both desktop and mobile you can export both logs from the Settings menu in the General section.

To view the exported logs on mobile you might want to install another app. While there are many decent apps for viewing log and text files on the Google Play store, we can recommend the following two apps:

FAQ

How well is my data protected?

EVE Buddy is designed to protect your data and tokens and has implemented the following safety measures:

  1. All data and tokens retrieved from CCP's servers are stored on your local computer only. Your data is therefore safe as long as you prevent any unauthorized access to the data on your computer.

  2. EVE Buddy also does not log any tokens (they are replaced with the text REDACTED). It is therefore safe to share your logs with maintainers for troubleshooting.

  3. EVE Buddy is fully compliant with the requirements for OAuth 2.0 for Mobile or Desktop Applications from CCP.

  4. In case you need to switch computers you can remove your data with the delete app.

Why do I not see all of my character's data in the app?

Some of your data from the game server might not be visible in EVE Buddy due to technical limitations of the game server API (ESI) or missing permissions.

When I try to add a character the app redirect to localhost. Should it not redirect to an CCP server?

No, the redirect to localhost is correct. This connects to EVE Buddy's own web server, which is needed for implementing CCP's authorization process called SSO. For more information please see the EVE Developer Documentation / SSO.

Server limitations

CCP's servers have limitations on how far back some character data can be retrieved.

Here is an overview of some limitations:

  • Wallet journal: 30 days, 2.500 entries
  • Wallet transaction: 2.500 entries

However, EVE Buddy will keep all historic data once retrieved. For example: If you allow EVE Buddy to update on a regular basis, it will be able to keep a record of your wallet transactions over many months and years.

Permissions

A special case are Upwell structures. Access to structures depends on in-game docking rights. Unfortunately, it is not possible to later retrieve the name or location of a structure, which the character no longer has access to. For example character assets might be displayed in an "unknown structure".

External web sites

You can find EVE Buddy mentions on other web sites:

Credits

The forecasts for planetary industry colonies are based on the colony simulation in RIFT Intel Fusion Tool by Nohus and used with permission.

"EVE", "EVE Online", "CCP", and all related logos and images are trademarks or registered trademarks of CCP hf.

Documentation

Overview

Evebuddy is a companion app for EVE Online players.

Source Files

View all Source files

Directories

Path Synopsis
internal
app
Package app is the root package of all domain related packages.
 Package app is the root package of all domain related packages.
app/asset
Package asset provides data structures to analyze and process asset data.
 Package asset provides data structures to analyze and process asset data.
app/characterservice
Package characterservice contains the EVE character service.
 Package characterservice contains the EVE character service.
app/colonysim
Package colonysim estimates the current state of a PI colony by simulating it forward in time from its last ESI snapshot.
 Package colonysim estimates the current state of a PI colony by simulating it forward in time from its last ESI snapshot.
app/corporationservice
Package corporationservice contains the corporation service.
 Package corporationservice contains the corporation service.
app/esistatusservice
Package esistatusservice contains the ESI status service.
 Package esistatusservice contains the ESI status service.
app/eveimageservice
Package eveimageservice contains the EVE image service.
 Package eveimageservice contains the EVE image service.
app/evenotification
Package evenotification contains the business logic for dealing with EVE Online notifications.
 Package evenotification contains the business logic for dealing with EVE Online notifications.
app/evenotification/notification2
Package notification2 defines types for parsing data of Eve notification types.
 Package notification2 defines types for parsing data of Eve notification types.
app/eveuniverseservice
Package eveuniverseservice contains EVE universe service.
 Package eveuniverseservice contains EVE universe service.
app/pcache
Package pcache implements a persistent cache.
 Package pcache implements a persistent cache.
app/settings
Package settings provides an API for reading and writing the app's settings.
 Package settings provides an API for reading and writing the app's settings.
app/statuscache
Package statuscache provides cached access to the current update status of entity sections.
 Package statuscache provides cached access to the current update status of entity sections.
app/storage
Package storage contains the logic for storing application data into a local SQLite database.
 Package storage contains the logic for storing application data into a local SQLite database.
app/storage/queries
app/testutil
Package testutil contains utilities for writing tests.
 Package testutil contains utilities for writing tests.
app/testutil/testdouble
Package testdouble provides test doubles of services.
 Package testdouble provides test doubles of services.
app/ui
Package ui contains the UI components.
 Package ui contains the UI components.
app/ui/charactermanager
Package charactermanager provides a window for managing Characters.
 Package charactermanager provides a window for managing Characters.
app/ui/core
Package core provides the core components to construct the UI.
 Package core provides the core components to construct the UI.
app/ui/filedialog
Package filedialog shows file dialogs, in a window on desktop and natively on mobile.
 Package filedialog shows file dialogs, in a window on desktop and natively on mobile.
app/ui/gamesearch
Package gamesearch provides widgets for building the game search UI.
 Package gamesearch provides widgets for building the game search UI.
app/ui/infoviewer
Package infoviewer provides a window for displaying information about Eve objects.
 Package infoviewer provides a window for displaying information about Eve objects.
app/ui/mailer
Package mailer provides the functionality to create a new window for composing and sending mail.
 Package mailer provides the functionality to create a new window for composing and sending mail.
app/ui/screens
Package screens provides UI components to build the various screens for character and corporation features
 Package screens provides UI components to build the various screens for character and corporation features
app/ui/settings
Package settings provides a window to view and configure user settings.
 Package settings provides a window to view and configure user settings.
app/ui/updatestatus
Package updatestatus shows the current update status in a window.
 Package updatestatus shows the current update status in a window.
deleteapp
Package deleteapp contains the Fyne app for deleting the current users's data.
 Package deleteapp contains the Fyne app for deleting the current users's data.
evehtml
Package evehtml provides converters to deal with EVE Online HTML.
 Package evehtml provides converters to deal with EVE Online HTML.
eveicon
Package eveicon provides access to Eve online icons as Fyne resource.
 Package eveicon provides access to Eve online icons as Fyne resource.
evesde
Package evesde provides data from the EVE Online static data exchange.
 Package evesde provides data from the EVE Online static data exchange.
github
Package github contains features for accessing repos on Github.
 Package github contains features for accessing repos on Github.
humanize
Package humanize transforms values into more user friendly representations.
 Package humanize transforms values into more user friendly representations.
icons
Package icons contains all bundeled app icons.
 Package icons contains all bundeled app icons.
janiceservice
Package janiceservice provides a service for accessing the Janice API.
 Package janiceservice provides a service for accessing the Janice API.
memcache
Package memcache implements a simple in-memory cache.
 Package memcache implements a simple in-memory cache.
migrate
Package migrate provides a simple mechanism for dealing with migrations of a SQLite database.
 Package migrate provides a simple mechanism for dealing with migrations of a SQLite database.
optional
Package optional provides the generic type Optional, which represents an optional value.
 Package optional provides the generic type Optional, which represents an optional value.
remoteservice
Package remoteservice provides a service for communicating between instances remotely.
 Package remoteservice provides a service for communicating between instances remotely.
singleinstance
Package singleinstance provides a mechanism to ensure only one instance of a function runs at a time.
 Package singleinstance provides a mechanism to ensure only one instance of a function runs at a time.
stack
Package stack provides a simple Stack container.
 Package stack provides a simple Stack container.
syncqueue
Package syncqueue provides queues for concurrent use.
 Package syncqueue provides queues for concurrent use.
xassert
Package xassert extends the testify assert package with additional test helpers.
 Package xassert extends the testify assert package with additional test helpers.
xdesktop
Package xdesktop extends Fyne's desktop package.
 Package xdesktop extends Fyne's desktop package.
xgoesi
Package xgoesi contains extensions to the antihax/goesi library.
 Package xgoesi contains extensions to the antihax/goesi library.
ximage
Package ximage contains tools for transforming image resources.
 Package ximage contains tools for transforming image resources.
xiter
Package xiter provides common iterator helper functions.
 Package xiter provides common iterator helper functions.
xlayout
Package xlayout extends Fyne's layout package.
 Package xlayout extends Fyne's layout package.
xmaps
Package xmaps provides an extension to the maps package.
 Package xmaps provides an extension to the maps package.
xsingleflight
Package xsingleflight provides extensions to Google's singleflight package.
 Package xsingleflight provides extensions to Google's singleflight package.
xslices
Package xslices contains helper functions for slices.
 Package xslices contains helper functions for slices.
xstrings
Package xstrings provides helpers for strings.
 Package xstrings provides helpers for strings.
xsync
Package xsync extends the standard sync package.
 Package xsync extends the standard sync package.
xwidget
Package xwidget extends the Fyne widget packages.
 Package xwidget extends the Fyne widget packages.
tools
dbperf command
dbperf is for measuring the DB performance.
 dbperf is for measuring the DB performance.
fakechars command
fakecorps command
geneveicons command
geneveicons generates a go source file containing a mapping for icon IDs to image files.
 geneveicons generates a go source file containing a mapping for icon IDs to image files.
gennotif command
gennpccorps command
gennpccorps generates a go source file containing additional information about NPC corporations.
 gennpccorps generates a go source file containing additional information about NPC corporations.
genplanetschematics command
genplanetschematics generates a go source file containing the inputs and outputs of planetary industry schematics.
 genplanetschematics generates a go source file containing the inputs and outputs of planetary industry schematics.
genratelimit command
genratelimit generates ESI rate limit information for the xgoesi package.
 genratelimit generates ESI rate limit information for the xgoesi package.
genschematicids command
genschematicids generates a go source file containing a mapping for schematic IDs to icon IDs.
 genschematicids generates a go source file containing a mapping for schematic IDs to icon IDs.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.