Repeaters & Channels from 1.63
On the road in the camper, on an activation or in an unfamiliar region: which repeater can I reach from here, and which tones does it need? The Repeaters module in the sidebar shows your channel list sorted by distance from your current location — with bearing, offset, CTCSS/DCS and mode. A double-click tunes the transceiver via CAT. The data lives in a local file; the module needs no network.
Layout
- Left: the shared CAT panel and below it Channel via CAT with the To Rig button and the report of what the rig accepted.
- Bar: location, band and mode filter, search, Favourites only and the actions New, Edit, Delete, Import CHIRP and Export CHIRP.
- Table: ★, Name, Call, Band, RX, Offset/TX, Tone, Mode, Distance, Bearing, Region. Columns can be sorted, reordered and shown or hidden with a right-click on the header (Type is hidden at first). The default sort is by distance; channels without a location go to the end.
- Detail at the bottom: all fields of the selected channel, tags, notes and the CHIRP comment, plus To Rig, To Logbook and the favourite star.
Location
Distance and bearing are computed from your locator — first the locator of the active log, otherwise the one from the settings. For "I'll be there soon" enter your own locator in the bar; it applies to this module only, and the ⓧ next to it restores the default. Channels without a location (CHIRP has no coordinates) get a locator in the editor.
Creating and editing channels
New opens the editor. Name, RX frequency and mode are required. Choose the offset as simplex, minus, plus, split (fixed TX frequency) or "TX locked"; for minus and plus the editor suggests the usual offset of the band (0.6 MHz on 2 m, 7.6 MHz on 70 cm, 28 MHz on 23 cm). Tones: send CTCSS, CTCSS with tone squelch, DCS with code and polarity, or "Cross" (passed through only). Mode names follow CHIRP: FM, NFM, AM, DV, DMR, DN (C4FM/Fusion), DIG — digital modes are kept as text in this stage. Plus callsign, locator, region, elevation, tags, favourite and notes.
A typo in the frequency blocks saving so that no stored frequency is silently overwritten. Delete asks first.
CHIRP import and export
CHIRP is the free programming tool for handhelds and mobile rigs; its CSV files are the common exchange format, and RepeaterBook and other lists provide it too.
- Import CHIRP… reads a CHIRP CSV (current CHIRP-next files with 21 columns, older ones with 18). Before anything is applied, a preview shows how many channels are new, updated or unchanged, plus notes on skipped lines. Existing channels are matched by name, frequency and callsign: favourite, location, region, tags and your notes are kept, the CHIRP fields are taken over. The CHIRP comment is a separate field and never replaces your notes.
- Location from the comment: a Maidenhead locator in the CHIRP comment is taken over, so lists without coordinates get distance and bearing too. The USKA repeater list ("Wolfwil SO JN37WQ – NFM T71.9") additionally yields town and canton as region and turns FM into NFM when the comment says NFM (CHIRP itself lists FM there). Only empty fields are filled; your own entries stay.
- Export CHIRP writes all channels, the selection or the favourites as CSV to
Exports/, in CHIRP's own notation. Imported channels keep every value and the column order of the source, including columns the module does not know (TStep, Power, the D-STAR fields). Channels you created yourself get the values CHIRP requires (offset 0, tone 88.5, DCS 023, 50 W). - Memory slots: if all exported channels have a unique CHIRP location it is kept; otherwise (partial export, self-created channels) the export renumbers from 0.
Repeaters from RepeaterBook
RepeaterBook is the largest repeater database and lets registered users export for their own use (no redistribution). This is how the repeaters of a country or region get into HAM-Tools:
- Log in on repeaterbook.com, run a search (e.g. country "Switzerland"), choose CHIRP in the export menu and save the CSV.
- From the same search also export KML — only that file contains the coordinates.
- In HAM-Tools run Import CHIRP… with the CSV, then Add RepeaterBook KML… with the KML. The step matches channels by callsign and output frequency and adds coordinates, location, the link to the RepeaterBook detail page and, for repeaters that are off air, the tag "QRT". Your own existing coordinates are left untouched.
The repeaters then have distance and bearing, and "Data courtesy of RepeaterBook.com" in the detail opens the detail page. RepeaterBook's CHIRP export carries 1750 as the transmit tone for many European repeaters: that is the 1750 Hz tone burst, not CTCSS. HAM-Tools shows it as "1750 Hz", never sends it as a CTCSS command, reminds you in the report to send the tone burst on the rig, and does not write it as a tone in the CHIRP export (CHIRP has no tone burst; with tone squelch the squelch tone goes there, otherwise 88.5).
File: ~/Documents/HAM-Tools/Repeater/channels.json. If it is damaged the module shows a red banner, blocks saving and leaves the file untouched.
To Rig
To Rig (double-click on a row or the button in the panel) sends one sequence: frequency, mode (FM or AM), offset with direction and width or split, then the tone (send CTCSS, tone squelch or DCS). What a rig can do via CAT depends on the model and the Hamlib backend:
- IC-9700, IC-705, IC-7100, FT-991, FTX-1, FTDX-10/101: offset, CTCSS and tone squelch via CAT. DCS: the codes go via CAT (Yaesu), switching DCS on stays on the rig — Hamlib has no command for it; the report line is yellow.
- IC-7300 and IC-7610 have no repeater offset (no 2 m/70 cm); frequency and mode work, the rest appears as a hint in the report.
- IC-705 in Wi-Fi mode: frequency, mode, offset and CTCSS/tone squelch directly via CI-V; green only once the rig acknowledges. Split channels and DCS on the rig.
- Flex: frequency and mode only.
The report in the panel shows each step in green ("set") or orange ("set on the rig"). The CAT connection stays up — a model that does not know a command is not an error. D-STAR (mode DV) is set via CAT when the rig supports it (IC-705, IC-9700, ID-5100). NFM goes out as narrow FM (Hamlib FMN, FM with filter 2 for the IC-705 in Wi-Fi mode); if the model has no FMN, FM is set and a yellow line says "choose the NFM filter on the rig". Always on the rig: DCS polarity, the filter width for DMR and C4FM, and the TX lock. With PTT pressed there is no QSY.
To Logbook
To Logbook opens the logbook with frequency, band and mode; the repeater's callsign (or the channel name) goes into the remark as "via …". The station field stays empty.
Outlook
A map with repeater markers, split and DCS in the IC-705 Wi-Fi client, D-STAR fields and GPS location are later stages (see the roadmap).