Bleeps
Guide

Using Bleeps

Everything from the first start to satellites. Bleeps works like WSJT-X where it can, so if you run FT8, most of this will feel familiar.

First start

Quick start

  1. Start Bleeps. The first time, Settings opens on its own.
  2. Station: enter your callsign.
  3. Audio: pick the input (from the radio) and the output (to the radio) — the same sound card you use for FT8.
  4. Radio: pick your radio and its COM port (or rigctld, FLRig, VOX or RTS/DTR PTT). Press OK.
  5. Click a band button (20m, 40m, …). The radio tunes to the Bleeps frequency of that band.
  6. Watch the waterfall: Bleeps signals are narrow four-tone stripes, and what is decoded appears in the chat.
  7. Type a line in the TX box and press Enter.
The Bleeps main window: radio bar and band buttons at the top, the chat, the TX line, and the waterfall
The main window: the radio bar and band buttons, the chat, the TX line and the waterfall.
Settings

Station and audio

Open with File → Settings…

SettingWhat it does
CallsignGoes out at the start of every message, so the others see who is talking.
ThemeSystem follows Windows, or always Light or Dark. Takes effect when Bleeps starts again.
Audio inputThe sound card input that carries the radio's receive audio.
Audio outputThe sound card output that goes to the radio's data or mic input.
Settings

Radio

One radio, no profiles — what you set here is what Bleeps uses. Fields that do not apply to your choice turn grey.

SettingWhat it does
RigYour radio from Hamlib's list. None (no CAT): no radio control, PTT on VOX or an RTS/DTR line still works. Hamlib NET rigctl talks to a running rigctld, FLRig to FLRig.
PortThe COM port of the radio, or host:port for rigctld (127.0.0.1:4532), FLRig (127.0.0.1:12345) or a radio on the network.
Baud rate, bits, handshakeMust match the radio's CAT menu. Default is what Hamlib uses for that radio.
DTR / RTSThe control lines of the CAT port. Some interfaces need one high (power) or low (to avoid keying the radio).
CI-V addressFor Icom, Xiegu and other CI-V radios. Filled in with the model's default from Hamlib; only change it if you changed it in the radio.
PTTCAT keys through Hamlib (also via rigctld/FLRig). RTS/DTR uses a serial line, on the CAT port or a PTT port of its own. VOX lets the radio key on the audio.
ModeWhat the radio is set to when you pick a band: Data (USB-D / DATA-U), USB, or None to leave it alone.
TX delay / PTT tailTime between PTT and the audio, and how long PTT stays down after it.
Poll everyHow often the frequency is read back from the radio.

Sharing the radio. Start rigctld yourself (for example rigctld -m 3073 -r COM5 -s 19200 for an IC-7300) and pick Hamlib NET rigctl with 127.0.0.1:4532 — handy when WSJT-X or a logger uses the radio too. For FLRig pick FLRig and 127.0.0.1:12345.

Operating

Bands and frequency

The bar at the top works like WSJT-X:

  • Band buttons — one per band in the frequency list. A band with more than one frequency opens a small menu. The button of the band the radio is on is orange.
  • Band box — pick a frequency, or type one in MHz (14.071) or a band (20m) and press Enter.
  • Dial — the radio's frequency. It follows the radio when you turn the knob; red means the radio does not answer.

The list itself is in Settings → Frequencies: a grid like WSJT-X's with band, frequency, IARU region and a description. Right-click the list for Insert, Delete and Reset to the defaults (the standard list, as on the home page).

The frequencies may still change. They are suggestions while Bleeps is new, and may move in a later version — above all when one turns out to disturb another mode: Bleeps does not want to get in the way of FT8, FT4, CW, RTTY, phone or anything else. Before you send, listen whether the frequency is free. After an update, right-click the list and choose Reset to the defaults to load the new standard list (your own additions are then gone, so note them first). The current list is always on the home page.

Operating

The waterfall

The waterfall shows the audio passband, built like WSJT-X's Wide Graph: fine resolution, averaged in power. A Bleeps signal is four thin lines next to each other; stations being decoded are marked with their call in their colour.

  • Click in the waterfall where you want to send. The red TX marker and the shaded strip show where your signal will be.
  • Free spot moves TX to the quietest place in the passband, away from strong stations.
ControlWhat it does
Bins/PixelHorizontal zoom: how many frequency bins one pixel holds. Clears the picture.
StartThe audio frequency (Hz) at the left edge. Clears the picture.
N AvgHow many spectra are averaged per line — the speed of the waterfall. 1 is the fastest; higher is slower and smoother.
GainContrast: higher makes weak signals stand out more.
ZeroMoves the noise floor up or down (brightness).
Operating

Chatting

  • Type in the TX box and press Enter (or Send). While one message goes out you can already type the next; the waiting ones show greyed at the bottom of the chat.
  • Esc (or Stop) stops sending at once. The others see the message end with ⚠.
  • Speed: Normal (about 3 characters/s, 83 Hz wide, the most robust) or Fast (twice as fast, 166 Hz wide). You choose the speed you send at; receiving always hears both.
  • Auto (free spot): at every Send Bleeps first checks your place. Still free, it stays — so your chat partner finds you again. Taken or busy, it moves to the quietest place, then sends.
  • The counter shows how much of a message is used: at most 250 bytes (an accent or € takes 2–3).
  • Emoji: click the 🙂 button, or type a classic smiley (:) ;) :D <3) or a code like :beer: — it turns into the emoji as you type.
  • Chat lines: hover a line to see its audio frequency and strength; a ✓ means the message came in complete and checked. Click a callsign to start your TX line with CALL: ; right-click a line to copy it, send next to that station, or give the station its own colour.

Every chat is saved per day in Documents\Bleeps\chat\YYYY-MM-DD.txt (File → Open the chat log folder).

Operating

TX drive and levels

The TX drive slider right of the waterfall attenuates the transmit audio in dB, like WSJT-X's Pwr. Set it so the radio's ALC stays (almost) still — a clean signal is decoded far better than a loud one. You can turn it while sending.

Advanced

More than one radio

Like WSJT-X's --rig-name, you can run several Bleeps at the same time, each with its own radio:

"C:\Program Files\Bleeps\Bleeps.exe" --rig IC9700

Each name gets its own settings (%APPDATA%\Bleeps - IC9700), its own logs and chat logs (Documents\Bleeps - IC9700) and its name in the title bar. Make a shortcut with the flag after the target to start it with one click. The same name cannot run twice.

Advanced

Full duplex and simplex

Bleeps was designed for full duplex, as on QO-100: you send on the uplink and receive the downlink at the same time. Turn on Full duplex in the chat settings (Settings… next to the TX line) and the decoder and the waterfall keep running while you send. You keep reading the others while your own line goes out, and your own signal coming back from the satellite is marked ↩ ✓ on your own line.

It works just as well in simplex, with one radio that either sends or receives. Leave Full duplex off then: the radio's receiver is muted while you send, and Bleeps listens between your messages.

QO-100

The 13cm entry is the QO-100 uplink (2400.060 MHz; the downlink is 10489.560). Feed the downlink receiver's audio to Bleeps' input and the uplink transmitter from Bleeps' output, and turn on Full duplex.

Full duplex with an external SDR receiver

On HF or VHF you can get full duplex too, with an external SDR receiver next to your radio:

  • The SDR receives: its audio goes to Bleeps' audio input. Tune it to the same Bleeps frequency, in USB.
  • The radio sends: Bleeps' audio output goes to its data input, with PTT as usual.
  • Turn on Full duplex. You now see your own signal in the waterfall while you send, and the others keep coming in.

Your own transmitter is very close. Keep the SDR's antenna well away from the transmitting antenna, or use a receiver that can take a strong signal, so it is not overloaded or damaged.

Advanced

Satellite radios (IC-9700)

IC-9700 and other satellite radios. Bleeps notices when the radio is in satellite mode and then shows TX = SUB (uplink) in the dial and RX = MAIN (downlink) next to it. Both are read automatically: the radio only reports the selected band, so Bleeps selects the other one for a moment every 2 seconds, reads it, and selects yours again — the way satellite programs do. Never while transmitting. Bleeps does not tune in satellite mode; that is up to you or your tracking program. This needs a direct connection to the radio (COM port or its network port), not rigctld or FLRig.

Reference

Where Bleeps keeps its files

WhatWhere
Settings%APPDATA%\Bleeps\bleeps.ini
Frequency list%APPDATA%\Bleeps\frequencies.json
Chat logs (per day)Documents\Bleeps\chat\
Debug logDocuments\Bleeps\debug\Bleeps.log (File → Open the log folder)

With --rig NAME the folders are called Bleeps - NAME.

Reference

Troubleshooting

ProblemTry this
Dial is red / “no CAT”Wrong COM port or baud rate, or another program has the port open. Close it, or share the radio through rigctld or FLRig.
Radio does not keyCheck PTT in Settings → Radio: the radio must accept CAT PTT; for RTS/DTR check the line and port; for VOX turn VOX on in the radio.
Nothing decodesCheck the audio input and level (the noise should be visible in the waterfall), and that the radio is in USB/DATA on the right frequency.
Others can't read youLower the TX drive until the ALC stays still.
Satellite mode shows -- . --- ---Bleeps reads MAIN and SUB itself within a few seconds — but not over rigctld/FLRig. Connect to the radio directly.
Something elseLook in the debug log (File → Open the log folder).