Repository navigation
Installation
EDLD is a Python daemon for real-time Elite Dangerous session monitoring on Linux. It supports two UI modes: a GTK4 graphical interface and a Textual terminal UI.
Arch ships current versions of everything EDLD needs.
sudo pacman -S python-psutil python-gobject gtk4
pip install discord-webhook cryptography --break-system-packagesgit clone https://github.com/drworman/EDLD.git
cd EDLD
bash install.sh
nano ~/.local/share/EDLD/config.toml # set JournalFolder at minimum
./edld.py # terminal output only
./edld.py --mode textual # Textual TUI
./edld.py --mode gtk4 # GTK4 GUIsudo apt install python3-psutil python3-gi gir1.2-gtk-4.0
pip install discord-webhook cryptography --break-system-packagesgit clone https://github.com/drworman/EDLD.git
cd EDLD
bash install.sh
nano ~/.local/share/EDLD/config.toml
./edld.py
./edld.py --mode textual
./edld.py --mode gtk4sudo dnf install python3-psutil python3-gobject gtk4
pip install discord-webhook cryptography --break-system-packages~/.local/share/EDLD/config.toml
~/.config/EDLD is a symlink to the same directory. A repo-adjacent config.toml is accepted as a development fallback.
If no config file is found on startup, EDLD creates one with safe defaults and prints its location. Edit it to set JournalFolder before restarting.
| Dependency | Purpose | Install method |
|---|---|---|
python-psutil |
Process utilities | Package manager |
python-gobject + gtk4
|
GTK4 GUI | Package manager |
discord-webhook |
Discord notifications | pip |
cryptography |
CAPI auth and secure transport | pip |
textual>=0.47 |
Textual TUI | pip (optional) |
Do not install
psutilorPyGObjectvia pip on Linux. They have C extensions that require system libraries only available through the distro package manager.
python3 -c "import psutil, discord_webhook, cryptography; print('All dependencies OK')"ModuleNotFoundError: No module named 'psutil'
Install via package manager: sudo pacman -S python-psutil (Arch) · sudo apt install python3-psutil (Debian/Ubuntu) · sudo dnf install python3-psutil (Fedora).
ModuleNotFoundError: No module named 'gi'
Install python-gobject (Arch) · python3-gi (Debian) · python3-gobject (Fedora), and GTK4 itself.
ModuleNotFoundError: No module named 'discord_webhook'
Run pip install discord-webhook --break-system-packages.
GLib.GError or blank GTK4 window
Ensure adwaita-icon-theme (or equivalent) is installed.
sshfs for remote access
sudo pacman -S sshfs (Arch) · sudo apt install sshfs (Debian/Ubuntu) · sudo dnf install fuse-sshfs (Fedora). See docs/guides/REMOTE_ACCESS.md.
Getting Started
Guides
Reference
- Automation
- Building
- Configuration
- Dossier
- Edcars
- Exploration Exobiology Plan
- Licensing
- Mission Bootstrap
- Privacy
- Roadmap
- Server
- Signing
- Startup
- Streamer Stats Overlay
- Surface Survey
- Terminal Output
- Theming
Releases