THIS PROGRAM WORKS SOLELY BY READING YOUR LOG FILE.

Instructions:

• Windows: Download the latest release, unzip EQTravelMap-vX.Y.Z-windows.zip, and run EQTravelMap.exe
• macOS: Download EQTravelMap-vX.Y.Z-macos.zip, unzip it, and open EQTravelMap.app (right-click → Open the first time to bypass Gatekeeper)
• Linux: Download EQTravelMap-vX.Y.Z-linux.tar.gz, extract it, and run ./EQTravelMap/EQTravelMap

Gorrek's EverQuest Travel Map

Generate a visual travel map and play summary from your EverQuest character's log files. Drop in your logs, pick your character, click Generate.

Gorrek_travel_short.mp4

What it does

Reads your EverQuest log files chronologically and draws every valid zone-to-zone trip on a map of the world. The colour of each line shows when in your character's history that trip happened (older trips are drawn on top so early adventures stay visible). Alongside the map, you get a copyable text summary of kills, deaths, level-ups, looted coin, and merchant earnings. You can also export an MP4 video that replays your whole journey, drawing the trips in order while the running stats tick up beside the map.

The map shown above was generated from the bundled sample log (samples/sample_eqlog_Gorrek_P1999Green.txt), a real Project 1999 character trimmed down to ~1.3 MB so the project ships with a working first-run example.

What you see on the output page

The results window has three things side-by-side under the rendered map:

• Top 5 killed creatures and Top 5 visited zones — the headline highlights of where you spent your time and what you fought there.
• Major Statistics — first log timestamp, total log lines, logins, deaths, zones visited, kills, levels lost, current level, looted coin, and coin earned from merchants.

Five buttons sit to the right of the map: NEW INPUT to parse another character, COPY TEXT to put the summary on your clipboard, SAVE MAP to export the rendered PNG anywhere on disk, MORE STATS to open the extra-stats window described below, and MAKE VIDEO to export an animated replay of your journey (see below).

Extra stats (MORE STATS button)

Click MORE STATS on the results window for a deeper breakdown that doesn't fit on the main summary:

• Top 25 visited zones — the long tail of where your character has been.
• Top 25 killed creatures — the long tail of what your character has killed.
• Top 25 cast spells — which spells you've leaned on the most.
• Max hit by damage type — your biggest single hit broken down by slash, pierce, backstab, bash, spell, crit, and any other damage types that turned up in the logs.

Travel-replay video (MAKE VIDEO button)

Click MAKE VIDEO on the results window to export an MP4 that replays your character's history from the beginning. The map starts empty and reveals each trip in chronological order, with a marker on your current zone, while the top-kills, top-zones, and major-statistics columns count up alongside it.

When you click the button you're asked how long the finished video should be. Pick one of the presets — 30 seconds, 1 minute, 2 minutes (the default), or 5 minutes — or enter a custom length (10–3600 seconds). The whole journey is always shown; a shorter duration just packs more events into each frame. Then choose where to save the .mp4 file. A progress dialog runs the export and can be cancelled at any time.

Video export needs the freshly parsed timeline, so it's available right after a Generate run. (The pre-built bundles ship the ffmpeg encoder needed to write the MP4; running from source pulls it in via imageio[ffmpeg].)

---

For EverQuest players (no Python or terminal needed)

Note: Pre-built bundles for Windows, macOS, and Linux are attached to each GitHub release. Download the one for your OS — there is nothing to install and no terminal commands to run.

Download and launch

OS	File	How to open
Windows	EQTravelMap-vX.Y.Z-windows.zip	Unzip anywhere, double-click EQTravelMap.exe
macOS	EQTravelMap-vX.Y.Z-macos.zip	Unzip, then right-click EQTravelMap.app → Open (required the first time to bypass Gatekeeper)
Linux	EQTravelMap-vX.Y.Z-linux.tar.gz	Extract, then run ./EQTravelMap/EQTravelMap from a terminal

macOS note: The app is ad-hoc signed but not notarized, so macOS will warn you the first time. Right-click → Open to proceed; after that it opens normally.

Windows note: The .exe is not code-signed (a signing certificate is an ongoing cost this free hobby project doesn't carry), so Windows will warn you the first time you run it:

• SmartScreen may show a blue "Windows protected your PC — unknown publisher" box. Click More info → Run anyway. This warning appears for any unsigned app and fades as a release accumulates downloads.
• Defender / antivirus may occasionally flag the bundle. This is a well-known false positive for apps packaged with PyInstaller — the launcher stub that unpacks the bundled Python runtime matches generic packer heuristics. The build deliberately avoids the worst triggers (no UPX compression, --onedir rather than a self-extracting single file) to keep flags rare.

This tool only ever reads your local EverQuest log files and writes a PNG to disk — it makes no network connections and installs nothing. You don't have to take that on faith: every release ships a SHA256SUMS-windows.txt file, the full source is on GitHub, and the bundle is built in public by GitHub Actions from pinned dependencies. See Verify your download below.

Verify your download (optional)

Every release attaches a SHA256SUMS-<os>.txt file. To confirm your download wasn't tampered with, check its hash against that file:

Windows (PowerShell)

Get-FileHash -Algorithm SHA256 EQTravelMap-vX.Y.Z-windows.zip
# compare the printed hash against the matching line in SHA256SUMS-windows.txt

macOS / Linux

shasum -a 256 -c SHA256SUMS-macos.txt    # or SHA256SUMS-linux.txt

If the hashes match, the archive is byte-for-byte the one the release workflow built.

Use it with your own EverQuest logs

1. In-game, type /log on once. EverQuest will start writing per-character log files into its Logs folder.

2. In the app, click Browse next to Log folder and pick that Logs folder. Common locations by OS:

   Windows

   • %USERPROFILE%\EverQuest\Logs
   • C:\EverQuest\Logs
   • C:\Program Files\Sony\EverQuest\Logs
   • C:\Program Files (x86)\Sony\EverQuest\Logs

   macOS

   • ~/EverQuest/Logs
   • ~/Library/Application Support/EverQuest/Logs

   Linux

   • ~/EverQuest/Logs
   • ~/.everquest/logs

3. Type your character's name exactly as it appears in the filename (eqlog_<Character>_P1999Green.txt → enter <Character>).

4. Click Generate. The longer your log history, the longer the parse takes — a multi-year archive can take a couple of minutes.

5. Use Save Map As… to keep the rendered PNG anywhere you like.

If anything goes wrong, the app shows a friendly explanation with a "Show Details" button for the technical message — paste that into a bug report and we'll take a look.

Try it on the bundled sample (no logs of your own required)

1. Download both files from the latest release: the bundle for your OS and EQTravelMap-samples.zip.
2. Extract both archives. Move the samples/ folder so it sits next to the EQTravelMap executable (or .app on macOS).
3. Launch the app. The form will be pre-filled with the samples/ folder and character name Gorrek. Click Generate.
4. After a few seconds you'll see the map and summary.

The sample logs ship as a separate, optional download so the main bundles stay small for users who already have their own EverQuest logs.

---

For command-line users

If you have Python 3.10+ and prefer running from source:

Windows (PowerShell)

git clone https://github.com/ajbtech/EQ-Travel-Map.git
cd EQ-Travel-Map
python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt

macOS / Linux

git clone https://github.com/ajbtech/EQ-Travel-Map.git
cd EQ-Travel-Map
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Launch the desktop GUI:

Windows

python src\desktop_app.py            # GUI, defaults pre-filled
python src\desktop_app.py Gorrek     # GUI, character name pre-filled

macOS / Linux

python src/desktop_app.py            # GUI, defaults pre-filled
python src/desktop_app.py Gorrek     # GUI, character name pre-filled

Or run the parser directly without the GUI:

Windows

python src\eq_parser.py Gorrek                              # uses default paths
python src\eq_parser.py Gorrek --log-folder samples         # use bundled sample
python src\eq_parser.py Gorrek --log-folder C:\path\to\logs --output map.png

macOS / Linux

python src/eq_parser.py Gorrek                              # uses default paths
python src/eq_parser.py Gorrek --log-folder samples         # use bundled sample
python src/eq_parser.py Gorrek --log-folder ~/path/to/logs --output map.png

eq_parser.py prints the summary to stdout and writes the map PNG to --output (default: ~/everquest_travel_map.png).

---

For developers

Full setup, testing, and packaging instructions live in CONTRIBUTING.md. The short version (commands are the same on all platforms; Windows users use python instead of python3):

pip install -e ".[dev]"
python -m pytest -q src
ruff check src && black --check src
pyinstaller --noconfirm --clean EQTravelMap.spec   # build the redistributable

The spec auto-detects the host OS: it picks icon.ico on Windows, icon.icns on macOS (generated by the CI build step), and icon.png on Linux, and applies ad-hoc codesigning on macOS.

Architecture and module conventions are documented in CLAUDE.md. Open work and good-first-issue ideas live in TODO.md.

The codebase splits into a streaming parse layer (src/log_parser.py, src/line_reader.py), a rendering layer (src/eq_display.py, src/map_path.py, src/zone_graph.py), a shared text-summary layer (src/summary_formatter.py), and a PySide6 GUI (src/desktop_app.py, src/ui/). Tests are colocated as src/test_*.py.

---

License & acknowledgments

This project is released under the MIT License.

It links against several third-party libraries that retain their own licenses, notably Qt 6 and PySide6 under LGPL-3.0. Distribution is LGPL-compliant because the bundle uses PyInstaller's --onedir mode (Qt DLLs remain replaceable). See LICENSES/README.md for the full attribution list and notes.

EverQuest and the world map artwork are property of Daybreak Game Company. This is an unofficial fan project with no affiliation to Daybreak or the Project 1999 team. The bundled data/zone_map.png is the Project 1999 Unofficial Zone Connection Map, originally created by Yurz Truly of the Project 1999 server and later expanded by Matthew Gordon Roulston (a.k.a Within Amnesia). Full per-file credits live in assets/ATTRIBUTION.md.

Special thanks to the Project 1999 community for keeping classic EverQuest alive and to everyone who has reported issues against this tool.

Made by Gorrek on the Green server.

---

Roadmap

See TODO.md for the maintainer's working notes and GitHub Issues for discussion. Post-1.0 ideas under consideration:

• Better Kunark zone center positions
• Live "follow me" view that updates the map as you play
• Zoom and pan in the desktop view
• Dynamic results-window resizing