JS8MapChat maps JS8Call callsigns in real time, with an optional fast chat window for communicating with each selected station.
JS8Map 1.75.1 and JS8FastChat 1.76 — Windows and Linux
Download the latest release — Windows installers and Linux packages.
FCC Lookup — offline callsign lookup for U.S. FCC and Canadian amateur licenses. Builds the same ham.db database JS8Map uses.
JS8Map Spotter — the upgrade of JS8Map 1.75, in its own repository: CommStat StatReps, MCForms and QSOs between other stations on the map, with tagged traffic tables. Installs alongside JS8Map 1.75 and works with JS8FastChat.
JS8MapChat is two programs that work together. Either one runs on its own; run both and a button in each window brings the other to the front.
Plots the stations JS8Call is hearing onto a live map. Markers are placed by looking the callsign up in the FCC and Canadian license databases, which JS8Map builds on your own machine.
- Filters for all stations, stations you hear, mutual contacts, and stations reaching you via heartbeat
- Relay path display, showing outbound and return legs as they complete
- Offline basemap, so the map draws with no internet connection
- Light and dark themes
A compact chat window for working a selected station without going back to the JS8Call interface.
- Message store and inbox
- Watch words
- Follows other traffic on frequency
- JS8Call, running, with its TCP API enabled
- TCP Max Connections set to 5 in JS8Call
- Windows 10 or later, or a current Linux desktop
JS8MapChat talks to JS8Call over its network API. It does not modify JS8Call.
Installers for Windows and packages for Linux are on the Releases page. Illustrated guides for both apps are in the docs folder.
JS8FastChat on Linux: download the _Linux.tar.gz into Downloads and paste the three lines in the JS8FastChat README, or follow Installing JS8FastChat on Linux.
JS8Map on Linux: install from inside the unpacked package folder.
| Key | Action |
|---|---|
F |
Fit all stations |
R |
Pull fresh data from JS8Call and rebuild |
/ |
Jump to the Find callsign box |
L |
Labels on and off |
D |
Dark and light theme |
1 |
Show all stations |
2 |
Show stations you hear |
3 |
Show mutual contacts |
4 |
Show stations reaching you via heartbeat |
+ |
Zoom in |
- |
Zoom out |
| Arrow keys | Pan |
| Shift + drag | Zoom to a box |
Esc |
Close a popup, or cancel a relay chain |
Ctrl + L |
Open the API log |
Ctrl + R |
Rebuild callsign coordinates |
Every key raises a short on-screen confirmation.
Both apps are Python. Windows builds use PyInstaller driven by the .bat files in each app folder, with Inno Setup for the installers. JS8Map's Linux build runs in a container and produces a .tar.gz package. JS8FastChat's Linux package is its Python source, run with the system's Python and Tk, so nothing is compiled; tools/make_release.py in its folder builds every FastChat package. How FastChat is put together is in its ARCHITECTURE.md.
shared_resolver.py exists separately inside each app and the two copies must stay byte-identical. check_twins.bat verifies this.
Callsign databases are not included. They are built on first run from public license data.
JS8Call by KN4CRD and contributors. JS8MapChat is an independent companion and is not affiliated with or endorsed by the JS8Call project.
Leaflet — map display library, © Vladimir Agafonkin and contributors, BSD 2-Clause licensed.
Map data — © OpenStreetMap contributors, available under the Open Database License. Basemap styling © CARTO.
FCC license database — United States government work, public domain. Canadian amateur callsign data — open data published by ISED Canada.
Copyright (C) 2026 MJ Jordan (KW3KW)
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
The full license text is in LICENSE.
Open an issue on the Issues tab. Please include: which app, Windows or Linux, your JS8Call version, and what you expected to happen.