Skip to content
D-ModemPublic

Repository files navigation

D-Modem/gui: D-Modem on the desktop

D-Modem desktop apps

Native apps for D-Modem on Windows, macOS and Linux.

Each app starts dmodemd (or connects to a dmodemd that already runs). It shows the modem as a desktop program. You can dial and answer from a window, change the settings without AT commands, and see the results of the last call. All three apps are thin native shells over one small C library, libdmodemctl. Thus they operate in the same way.

  • Modem: the state of the call, dial, answer and hang up, and the line that the modem uses
  • Phone: voice calls through the sound card (dial, answer, keypad), and an answering machine that takes messages on this computer when you enable it (disabled by default)
  • Terminal: the AT console, and the setup screens of the modem (AT!CF, AT!CT)
  • Remote: log in to a server by SSH, Telnet or rlogin, in a separate terminal. SSH is built in, on libssh: it uses the keys, agent, config and known hosts of OpenSSH. It can use or import the .ppk keys of PuTTY. It uses Pageant on Windows, and an ssh-agent on Linux and macOS. On Windows 95, SSH needs CryptoAPI (Windows 95 OSR2, or Internet Explorer 3 or later)
  • Terminal types: the two terminals use the emulator of the D-Modem app, ported to C: xterm, the VT52 to VT525 of DEC, ANSI-BBS (with Avatar, RIPscrip and Amiga ANSI), the PETSCII of the Commodores, the ATASCII of the Atari 8-bit and the ST, Viewdata, the Minitel and the Tektronix 4014. They have sixel, ReGIS and Tektronix graphics, and the font of each machine (the SyncTERM copies of their ROMs, LGPL-2.0-or-later: core/licenses/syncterm-fonts-LGPL-2.0.txt)
  • File transfers (Windows app): send and receive files on the modem line or on a Telnet, rlogin or SSH login. The protocols are the same as the D-Modem app: ZMODEM (with Automatic Receive when the remote side starts sz, rz or kermit -s, with Crash Recovery, and with zstd compression to the D-Modem BBS and app), YMODEM, YMODEM-G, XMODEM, XMODEM-1K, Kermit, Intel HEX, Motorola S-records and plain text. Use the Transfer menu, or the Send and Receive buttons of the Terminal page
  • Copy and capture (Windows app): select text with the mouse (Shift and the mouse when the remote side uses the mouse), then copy it. Paste to Host, Select All, Capture Text (to a file), Capture to Printer, and Print (the screen or the selection). Text that the remote side sends to its printer port goes to the printer. Use the Edit and Transfer menus, or click the right mouse button on the terminal
  • ASCII Setup (Windows app, Modem menu): the same items as HyperTerminal. For the data that you send: Enter sends CR LF, the local echo, and the line delay and character delay of a text file. For the data that you receive: an LF after each CR, 7-bit ASCII, and the wrap of long lines. The settings apply to the modem terminal and to the Remote terminal
  • Terminal Settings (Windows app, Modem menu): the same items as HyperTerminal, for the modem terminal and for the Remote terminal. They are what Backspace sends (Ctrl+H, Del, or Ctrl+H, Space, Ctrl+H), the function, arrow and Ctrl keys as terminal keys or Windows keys, the backscroll buffer lines, the font, the cursor, the Telnet terminal ID, and Exit program upon disconnecting. The status bar shows the connect timer during a call
  • Call menu (Windows app): Call (sessions with a name and a number, as the connection files of HyperTerminal), Wait for a Call (ATS0=1), Disconnect, and Send Break (Ctrl+Break: a COM port or a Telnet connection). Line Settings has the COM port settings: bits per second, data bits, parity, stop bits and flow control
  • Settings: each modem setting as a native control, from AT!M
  • Call Stats: the rate, modulation, error control and line figures of the last call (AT#UD, ATI11)
  • Line settings: a SIP account, a USB modem, or a modem that already runs (dmodemd, or a hardware modem such as the MultiTech MT9234MU)
  • Windows 95 and later: plain Win32, built with clang-retro. On Windows 9x, the app connects to a modem through TCP or a COM port
  • The Windows app on Linux and macOS (first pass): the same Win32 code, built over the portable Win32 layer of clang-retro MFC. At this time, it connects to a modem through TCP only, and the Phone page cannot play or record sound. Refer to "The Windows app on Linux and macOS" in Design
Windows macOS Linux
Toolkit Win32, C++ SwiftUI GTK 4, libadwaita
Runs on Windows 95 and later macOS 13 and later GTK 4.10 and libadwaita 1.5 or later (Ubuntu 24.04, Fedora 40)

The Linux app's Settings page The Windows app's Terminal with the modem's setup screen

The Linux app's Phone page The Windows app's Phone page taking a message

Nightly builds

The nightly release has the apps from the newest build of main. It has the Windows app (for Windows 95 and later, and for Windows 7 and later), the Linux app, the macOS app, and the Windows app for Linux and macOS. A workflow (.github/workflows/nightly.yml) replaces the release one time each day. When main has no new commits, the release does not change.

These builds are not stable releases. The files are not signed. Thus Windows and macOS can show a warning before the app starts.

Quick start

Linux:

sudo apt install cmake libgtk-4-dev libadwaita-1-dev libpulse-dev \
    libsndfile1-dev
cmake -S . -B build && cmake --build build && ./build/linux/dmodem-gui

Windows: we build the Windows app with clang-retro. Get its toolchain package (clang-dos-linux-x86_64.tar.xz or clang-dos-windows-x86_64.zip, from the nightly release). Then set CLANG_DOS to the directory of the package:

# Windows 95, 98, ME, NT 4.0 and later (no C runtime DLL)
cmake -S . -B build/win9x -G Ninja -DCMAKE_BUILD_TYPE=Release \
    -DCLANG_DOS=/opt/clang-dos -DCMAKE_TOOLCHAIN_FILE=cmake/clang-retro.cmake
cmake --build build/win9x

# Windows 7 and later
cmake -S . -B build/win7 -G Ninja -DCMAKE_BUILD_TYPE=Release \
    -DCLANG_DOS=/opt/clang-dos -DCMAKE_TOOLCHAIN_FILE=cmake/clang-retro.cmake \
    -DCLANG_RETRO_CONFIG=win7
cmake --build build/win7

The app is in windows/dmodem.exe of the build directory. MSVC (cmake -S . -B build -A Win32) and MinGW also build the same code.

macOS: first use cmake -S . -B build -DCMAKE_OSX_ARCHITECTURES="arm64;x86_64" -DCMAKE_OSX_DEPLOYMENT_TARGET=13.0 && cmake --build build (this builds libssh, for SSH). Then use brew install xcodegen && cd macos && xcodegen && open DModem.xcodeproj.

The Windows app on Linux or macOS: get clang-retro MFC, clang and llvm-rc (on macOS, brew install llvm). Then:

cmake -S . -B build -DDMODEM_GUI_WINPORT=ON -DCLANG_RETRO_MFC=/path/to/mfc \
    -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
cmake --build build --target dmodem-win32 && ./build/winport/dmodem-win32

The first CMake build downloads libssh and mbedTLS for SSH. This always occurs on Windows and macOS. Use -DDMODEM_GUI_SSH=OFF for a build with no SSH. On Linux, it occurs if the libssh of the system is older than 0.11.

The Settings page needs a dmodemd with AT!M (the main branch of D-Modem since D-Modem/D-Modem#103). The other pages operate with all versions of D-Modem 1.0.

Documentation

  • Design: how the apps are built, what they share, hardware modems (the MultiTech MT9234MU), the Windows 9x notes, and the Windows app on Linux and macOS
  • libdmodemctl: the API of the library
  • Documentation style: the rules for ASD-STE100 Simplified Technical English

The D-Modem suite

Repository What it is
D-Modem The open V.92 softmodem: dmodemd, libdmodem and the Asterisk, FreeSWITCH and ARI modules
app The D-Modem app for Android and iOS: a dial-up modem on a SIP call
gui D-Modem on the desktop: native apps for Windows, macOS and Linux
hardware pico-serial: RP2040 serial adapters and phone-line USB sticks
menu modemmenu: the login and menu dial-up callers reach
bbs A bulletin board for telnet, SSH, TN3270 and modem callers
go3270 A Go library for 3270 terminal servers, used by bbs
brand Logos, colours, type and the naming guide

Licence

AGPL-3.0-only (LICENSE), or a commercial licence from the D-Modem Authors (COMMERCIAL-LICENSE.md). Contributions come with a contributor agreement (CONTRIBUTING.md).

Releases

Contributors

Languages