Skip to content

GeneraBlack/PyMon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

13 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›°οΈ PyMon – EVE Online Character Monitor

A modern Python rewrite of EVEMon, the classic EVE Online character monitoring tool.

Built with Python 3.11+ and PySide6 (Qt 6), PyMon provides a dark-themed, feature-complete desktop application for managing your EVE Online characters.

Python Qt License Platform


✨ Features

πŸ“Š Character Monitoring (36+ Tabs)

  • Overview – Profile, Corporation, Attributes, ISK, Security Status, Employment History
  • Skill Queue – Live progress bars, SP/h, completion dates
  • Skills – Grouped by category, level indicators, total SP
  • Wallet – Journal, Transactions, ISK Sparkline, Balance Chart
  • Assets – Grouped by location, value estimates, BPC tags
  • Contracts – Type, status, prices, detail popup with items
  • Industry Jobs – Progress bars, timers, status grouping
  • Market Orders – Volume bars, expiry warnings, totals
  • Market Browser – Search, order book, price charts, region comparison
  • Blueprints – ME/TE bars, BPO/BPC separation, research status
  • Killmails – Full details, attackers, items, Kill/Loss
  • EVE Mail – Body preview, read/unread status
  • Contacts & Standings – 7-tier colors, gradient bars
  • Notifications – 80+ types, categorized
  • PI – Planet types, update warnings, CC Level
  • Mining Ledger – Sparklines, ore aggregation, ISK estimates
  • Clones & Implants – Color-coded, Jump Clone locations
  • Loyalty Points – LP per corp with bars
  • Factional Warfare – Faction colors, rank, kill/VP stats
  • And many more…

πŸ“‹ Skill Planner

  • Skill browser with group filtering & search
  • Training time calculation (per level & cumulative)
  • Prerequisite tree (color-coded βœ“/βœ—)
  • Attribute optimizer (remap recommendations)
  • Skill Explorer ("What does this skill unlock?")
  • Multi-plan support with SQLite persistence
  • Plan Import/Export (JSON), Print, EFT Loadout Import
  • Blank Character simulation

πŸ”§ Additional Tools

  • ISK Chart – Interactive balance history (pyqtgraph)
  • SP Chart – SP distribution by skill group
  • Character Comparison – Side-by-side stats
  • Certificate & Mastery Browser – Requirements checking
  • Implant Calculator – Attribute bonuses & training impact
  • Ship Browser – Ship class tree with bonuses/traits
  • Path Finder – Dijkstra route planning with sec filters
  • SDE Data Browser – Browse all 65+ game data tables
  • Trade Advisor – Buy/sell recommendations for mining & manufacturing
  • API Tester – Custom ESI endpoint testing
  • Schedule Editor – 7Γ—24h weekly planner

πŸ–₯️ System & UI

  • EVE SSO OAuth2 PKCE – Secure browser-based login
  • Dark Theme – EVE-inspired, centralized theme system
  • Multi-Window / Multi-Monitor – Detachable tabs with layout persistence
  • System Tray – Skill completion notifications (configurable)
  • Auto-Refresh – Timer with countdown
  • CSV & ICS Export – Export data and skill queue to calendar
  • E-Mail Notifications – SMTP-based alerts
  • Cloud Sync – Export/Import to Dropbox/GDrive/OneDrive
  • Auto-Update – GitHub release checking
  • SDE Online Updater – Download latest game data automatically

πŸš€ Installation

Option A: Windows Installer (empfohlen fΓΌr Benutzer)

  1. Gehe zu Releases
  2. Lade eine der beiden Varianten herunter:
    • PyMon-x.x.x-Setup.exe – Installer mit StartmenΓΌ-Eintrag, Desktop-VerknΓΌpfung & optionalem Autostart
    • PyMon-x.x.x-Windows-Portable.zip – Portable Version (einfach entpacken und starten)
  3. Starte PyMon.exe
  4. Beim ersten Start ΓΆffnet sich automatisch der Einrichtungsassistent, der dich Schritt fΓΌr Schritt durch die ESI-API-Einrichtung fΓΌhrt πŸ§™

Das war's! Du brauchst kein Python, kein Git, keine Kommandozeile.

Option B: Aus dem Quellcode (fΓΌr Entwickler)

Voraussetzungen

# Repository klonen
git clone https://github.com/GeneraBlack/PyMon.git
cd PyMon

# Virtuelle Umgebung erstellen (empfohlen)
python -m venv .venv

# Aktivieren
# Windows PowerShell:
.venv\Scripts\Activate.ps1
# Windows CMD:
.venv\Scripts\activate.bat
# Linux/macOS:
source .venv/bin/activate

# PyMon installieren
pip install -e .

# Starten
pymon

πŸ”‘ Ersteinrichtung (ESI API Key)

Beim ersten Start fΓΌhrt dich der eingebaute Einrichtungsassistent automatisch durch diese Schritte:

  1. Γ–ffne das EVE Developer Portal
  2. Erstelle eine neue Application:
    • Connection Type: Authentication & API Access
    • Callback URL: http://localhost:8182/callback
    • Scopes: Alle auswΓ€hlen (oder nur die gewΓΌnschten)
  3. Kopiere die Client ID und fΓΌge sie im Wizard ein
  4. Fertig! Klicke auf "Charakter hinzufΓΌgen" und logge dich via EVE SSO ein

πŸ’‘ Du kannst den Einrichtungsassistenten jederzeit ΓΌber Hilfe β†’ Einrichtungsassistent erneut aufrufen.


πŸ”„ Aktualisierung

Installer-Version

PyMon prΓΌft beim Start automatisch auf Updates. Alternativ lade einfach den neuesten Installer von der Releases-Seite herunter.

Quellcode-Version

cd PyMon
git pull
pip install -e .

Deine Einstellungen und Charakterdaten bleiben erhalten.


πŸ—οΈ Entwicklung

# Mit Dev-Dependencies installieren
pip install -e ".[dev]"

# Tests ausfΓΌhren
pytest -v

# Lint
ruff check pymon/

# Type-Check
mypy pymon/

Projektstruktur

pymon/
β”œβ”€β”€ pymon/                  # Hauptpaket
β”‚   β”œβ”€β”€ __main__.py         # Einstiegspunkt
β”‚   β”œβ”€β”€ core/               # App-Lifecycle, Config, Datenbank
β”‚   β”œβ”€β”€ auth/               # EVE SSO OAuth2 (PKCE)
β”‚   β”œβ”€β”€ api/                # 30 ESI API Module (80+ Endpunkte)
β”‚   β”œβ”€β”€ sde/                # Static Data Export (SQLite, 65+ Tabellen)
β”‚   β”œβ”€β”€ models/             # Datenmodelle (Dataclasses)
β”‚   β”œβ”€β”€ services/           # Business-Logik, Name Resolution, Markt
β”‚   └── ui/                 # PySide6 GUI (25+ Widgets)
β”œβ”€β”€ tests/                  # Testsuite
β”œβ”€β”€ pyproject.toml          # Dependencies & Build-Konfiguration
└── README.md

πŸ“¦ Standalone-EXE bauen (Windows)

pip install -e ".[build]"
pyinstaller pymon.spec

Die fertige EXE findest du in dist/PyMon/.


βš™οΈ Konfiguration

Alle Daten werden lokal in deinem App-Verzeichnis gespeichert:

  • Windows: %LOCALAPPDATA%\PyMon\PyMon\
  • Linux: ~/.local/share/PyMon/
  • macOS: ~/Library/Application Support/PyMon/
Einstellung Beschreibung
Client ID Deine EVE Application Client ID
Aktualisierungsintervall ESI-Abfrageintervall (Minuten)
Tray-Benachrichtigungen Skill fertig / Queue leer Benachrichtigungen
E-Mail SMTP-Einstellungen fΓΌr E-Mail-Alerts
Cloud Sync Cloud-Ordner fΓΌr Backup/Restore

πŸ“„ Lizenz

Lizenziert unter der Apache License 2.0.

πŸ™ Credits

About

A Rewrite of EVEMon in Python and up to date with the newest API and SDI

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors