Getting Started: Difference between revisions
Rework documentation for new users: illustrated steps, clear navigation, preserved technical references, and current 0.3.6 behavior |
Simplify user guides and use the cleaned transmitter illustration |
||
| Line 6: | Line 6: | ||
# Open the [https://simtx.net/downloads official downloads page] and download the latest '''SimTX transmitter''' JAR file. | # Open the [https://simtx.net/downloads official downloads page] and download the latest '''SimTX transmitter''' JAR file. | ||
# Install '''Java 21 or newer''' for your operating system if it is not already installed. [https://adoptium.net/temurin/releases/?version=21 Eclipse Temurin] provides Java downloads: choose version 21 or newer and the installer for your system. A Java installation with desktop support is required. | # Install '''Java 21 or newer''' for your operating system if it is not already installed. [https://adoptium.net/temurin/releases/?version=21 Eclipse Temurin] provides Java downloads: choose version 21 or newer and the installer for your system. A Java installation with desktop support is required. | ||
# Keep the JAR in a folder where you can save files | # Keep the JAR in a folder where you can save files. | ||
# Open the JAR. If double-clicking opens an archive program or does nothing, open a terminal in the folder containing the download and run the command below, using the actual downloaded filename. | # Open the JAR. If double-clicking opens an archive program or does nothing, open a terminal in the folder containing the download and run the command below, using the actual downloaded filename. | ||
| Line 15: | Line 15: | ||
The filename above is an example for version 0.3.6. Use the filename on the downloads page for a newer version. <code>java -version</code> shows which Java version the terminal is using. See [[Troubleshooting#The application will not open|startup troubleshooting]] if Java is missing or too old. | The filename above is an example for version 0.3.6. Use the filename on the downloads page for a newer version. <code>java -version</code> shows which Java version the terminal is using. See [[Troubleshooting#The application will not open|startup troubleshooting]] if Java is missing or too old. | ||
The steps and screenshots here describe the 0.3.6 interface. | |||
== 2. Sign in and choose a server == | == 2. Sign in and choose a server == | ||
# In '''Connect your SimTX account''', use '''Open browser''' and complete SimTX sign-in. If the browser asks for a code, enter the code shown by the app. '''Copy link''' lets you open the same sign-in page manually. | # In '''Connect your SimTX account''', use '''Open browser''' and complete SimTX sign-in. If the browser asks for a code, enter the code shown by the app. '''Copy link''' lets you open the same sign-in page manually. | ||
# Approve the app in the browser, then return to the transmitter. The app continues when approval is received. | # Approve the app in the browser, then return to the transmitter. The app continues when approval is received. | ||
# In '''Select SimTX Server''', select a server and press '''Connect''' | # In '''Select SimTX Server''', select a server and press '''Connect'''. | ||
Your SimTX account is separate from a wiki editing account | Your SimTX account is separate from a wiki editing account. If the app restores an existing sign-in, it can go directly to server selection. | ||
'''Checkpoint:''' the main window is open and the Station section identifies the selected server. Use '''Disconnect''' to return to server selection. An unavailable server or failed sign-in is covered in [[Troubleshooting]]. | '''Checkpoint:''' the main window is open and the Station section identifies the selected server. Use '''Disconnect''' to return to server selection. An unavailable server or failed sign-in is covered in [[Troubleshooting]]. | ||
| Line 29: | Line 29: | ||
The left-hand side contains the setup. Scroll down inside it if the Antenna section or Start TX is below the window edge. | The left-hand side contains the setup. Scroll down inside it if the Antenna section or Start TX is below the window edge. | ||
[[File:SimTX-0.3.6-first-transmission-guide.png|thumb|center|900px|alt=Annotated transmitter window with pointers to the station, RF Signal, Transmission Source, Antenna, Start TX, and monitoring controls.| | [[File:SimTX-0.3.6-first-transmission-guide-clean.png|thumb|center|900px|alt=Annotated transmitter window with pointers to the station, RF Signal, Transmission Source, Antenna, Start TX, and monitoring controls.|The main controls for your first transmission.]] | ||
# Under '''Station''', replace the example callsign with a name for your station. Click the map to choose the simulated station location, or enter latitude and longitude. | # Under '''Station''', replace the example callsign with a name for your station. Click the map to choose the simulated station location, or enter latitude and longitude. | ||
| Line 37: | Line 37: | ||
# Under '''Antenna''', choose '''Dipole''', set '''Wire Length (m)''' to <code>31</code>, '''Height (m)''' to <code>10</code>, '''Azimuth''' to <code>0</code>, and '''Feedline Loss (dB)''' to <code>1</code>. | # Under '''Antenna''', choose '''Dipole''', set '''Wire Length (m)''' to <code>31</code>, '''Height (m)''' to <code>10</code>, '''Azimuth''' to <code>0</code>, and '''Feedline Loss (dB)''' to <code>1</code>. | ||
This is | This antenna setup is for the frequency above. See [[Antenna System]] when changing frequency. | ||
== 4. Choose an audio file == | == 4. Choose an audio file == | ||
| Line 46: | Line 44: | ||
# Leave '''Audio Gain''' at <code>0.9</code>. Leave '''Repeat''' off for the first test so the session ends when the file ends. | # Leave '''Audio Gain''' at <code>0.9</code>. Leave '''Repeat''' off for the first test so the session ends when the file ends. | ||
'''Checkpoint:''' the Audio File row shows the selected filename. | '''Checkpoint:''' the Audio File row shows the selected filename. See [[Transmission Sources]] for microphones and streams. | ||
== 5. Start and check the transmission == | == 5. Start and check the transmission == | ||
# Press '''Start TX''' once. | # Press '''Start TX''' once. | ||
# Find the new row under '''Active Sessions'''. '''Running''' means it has started. '''Queued''' means it is waiting for capacity and will start automatically; do not keep pressing Start TX. | # Find the new row under '''Active Sessions'''. '''Running''' means it has started. '''Queued''' means it is waiting for capacity and will start automatically; do not keep pressing Start TX. | ||
# Select the running session. | # Select the running session. Check the Radio Deck meters. '''FWD''' is outgoing power, '''SWR''' indicates antenna matching, and '''TEMP''' is the simulated amplifier temperature. | ||
# Press '''Listen to Own TX''' to check the selected signal before propagation. This tests the transmitted audio, not whether a distant listener can receive it. | # Press '''Listen to Own TX''' to check the selected signal before propagation. This tests the transmitted audio, not whether a distant listener can receive it. | ||
Revision as of 22:12, 13 September 2026
This guide takes a new user from downloading SimTX to sending an audio file. TX means transmit. All signals in this guide are simulated; a physical transmitter, antenna, or microphone is not required.
1. Download and open the transmitter
- Open the official downloads page and download the latest SimTX transmitter JAR file.
- Install Java 21 or newer for your operating system if it is not already installed. Eclipse Temurin provides Java downloads: choose version 21 or newer and the installer for your system. A Java installation with desktop support is required.
- Keep the JAR in a folder where you can save files.
- Open the JAR. If double-clicking opens an archive program or does nothing, open a terminal in the folder containing the download and run the command below, using the actual downloaded filename.
java -jar simtx-transmitter-0.3.6.jar
The filename above is an example for version 0.3.6. Use the filename on the downloads page for a newer version. java -version shows which Java version the terminal is using. See startup troubleshooting if Java is missing or too old.
The steps and screenshots here describe the 0.3.6 interface.
2. Sign in and choose a server
- In Connect your SimTX account, use Open browser and complete SimTX sign-in. If the browser asks for a code, enter the code shown by the app. Copy link lets you open the same sign-in page manually.
- Approve the app in the browser, then return to the transmitter. The app continues when approval is received.
- In Select SimTX Server, select a server and press Connect.
Your SimTX account is separate from a wiki editing account. If the app restores an existing sign-in, it can go directly to server selection.
Checkpoint: the main window is open and the Station section identifies the selected server. Use Disconnect to return to server selection. An unavailable server or failed sign-in is covered in Troubleshooting.
3. Enter a simple station setup
The left-hand side contains the setup. Scroll down inside it if the Antenna section or Start TX is below the window edge.

- Under Station, replace the example callsign with a name for your station. Click the map to choose the simulated station location, or enter latitude and longitude.
- Under RF Signal, choose Generic HF transceiver and set Power (W) to
100. - Set Frequency (Hz) to
4625000. This is 4625 kHz, or 4.625 MHz. Enter the value in hertz, not4625. - Choose AM Double Sideband Full Carrier and tick Auto beside Bandwidth. This selects a 10000 Hz bandwidth for ordinary AM audio. Leave the advanced transmitter settings closed.
- Under Antenna, choose Dipole, set Wire Length (m) to
31, Height (m) to10, Azimuth to0, and Feedline Loss (dB) to1.
This antenna setup is for the frequency above. See Antenna System when changing frequency.
4. Choose an audio file
- Under Transmission Source, select Audio File.
- Press Choose... and select a short audio file. WAV, MP3, AIFF, AIF, and AU are supported. A supported file can also be dragged onto the window.
- Leave Audio Gain at
0.9. Leave Repeat off for the first test so the session ends when the file ends.
Checkpoint: the Audio File row shows the selected filename. See Transmission Sources for microphones and streams.
5. Start and check the transmission
- Press Start TX once.
- Find the new row under Active Sessions. Running means it has started. Queued means it is waiting for capacity and will start automatically; do not keep pressing Start TX.
- Select the running session. Check the Radio Deck meters. FWD is outgoing power, SWR indicates antenna matching, and TEMP is the simulated amplifier temperature.
- Press Listen to Own TX to check the selected signal before propagation. This tests the transmitted audio, not whether a distant listener can receive it.
To check reception elsewhere, use a receiver connected to the same server, tune to 4625 kHz, and select AM with a suitable bandwidth. Propagation Basics explains why a distant receiver may hear a weak signal even when the local monitor sounds clear.
If the session fails, read its error before changing settings. See Troubleshooting for silence, queueing, high SWR, and heat warnings. The default frequency is an example, not a reserved empty channel; choose another frequency and retune the antenna if needed for normal operation.
6. Stop and save
- Select the session and press Stop Selected, or use Stop All to end all your sessions. A non-repeating file also finishes by itself.
- Use Clear Finished to remove completed rows from the list.
- Open Presets and choose Save Current Settings.... Save the
.stxpresetfile with a descriptive name.
Restore it later with Presets > Load Preset File.... Keep any referenced audio files available at their saved paths. This station preset saves the complete setup; Radio Preset only sets the simulated radio's power and character.