cool-retro-term: A Qt6 and QML retro terminal emulator
A retro terminal emulator for Linux and macOS that uses Qt6, QML, and screen effects instead of a standard terminal look.
GitHub Swordfish90/cool-retro-term Updated 2026-09-14 Branch master Stars 26.2K Forks 1.0K
QML C++ GLSL Qt6 Terminal emulator Linux macOS

🧭 Decision Guide

Try it if you

  • You are on Linux or macOS and need a terminal emulator with cathode-ray tube visuals.
    The README Description says it mimics old cathode tube screens and works under Linux and macOS.
  • You want to adjust terminal colors, fonts, and effects through a context menu.
    The README Description says settings such as colors, fonts, and effects are available via the context menu.
  • Your project uses Qt6, QML, or C++ and you want to inspect terminal emulator implementation.
    The project uses QML, C++, GLSL, and QMake; the README also states that it uses the QML port of qtermwidget.

Skip it if you

  • Your target environment is Windows.
    The README Description only states that the terminal works under Linux and macOS.
  • Your environment cannot install Qt6.
    The README Description explicitly says that it requires Qt6.
  • You require the latest release to be stable, while the current version is 2.0.0-beta2.
    Project release information identifies 2.0.0-beta2 as the latest version.

Requirements

  • Runtime platforms: Linux or macOS.
  • Runtime dependency: Qt6.
  • Installation: get an AppImage from Releases for Linux or a dmg for macOS.
  • Ubuntu, Fedora, and Arch may also provide cool-retro-term in their official repositories.

Watch out

  • Source builds cannot be copied from a README command; consult the Linux or macOS build instructions in the Wiki.
    The README Building section only points to the Linux and macOS Build Instructions Wiki pages and provides no build command.
  • The package format depends on the operating system: AppImage for Linux and dmg for macOS.
    The README Install section explicitly lists a Linux AppImage and a macOS dmg.
  • Visual settings are exposed through a context menu rather than README-listed command-line parameters.
    The README Description says colors, fonts, and effects are accessed through the context menu.

Not stated in the README

  • The README does not specify the exact Qt6 minor version, compiler version, or complete dependency list.
  • The README does not state whether Windows has a usable build or package.
  • The README provides no performance metrics and does not state GPU or hardware requirements for GLSL effects.
  • The README does not describe changes or stability improvements in 2.0.0-beta2.
  • The license is not specified in the project metadata.
  • The README does not specify terminal compatibility, Shell compatibility, or the exact qtermwidget version.

💡 Deep Analysis

6
No I manage a set of Windows-only workstations and want to standardize a CRT-style terminal emulator. Since the README only mentions Linux and macOS, should I choose cool-retro-term?
For: A system administrator who must standardize a terminal tool on Windows workstations without relying on Linux or macOS

No, because the project explicitly names Linux and macOS as its supported platforms and provides no Windows support or installer information.

  • The README says, “This terminal emulator works under Linux and macOS and requires Qt6”; Windows is not included in the stated platform scope.
  • The Install section lists a Linux AppImage, a macOS dmg, and packages for Linux distributions, but no Windows installer or Windows build instructions.
  • Project topics include linux, macos, qml, qt, retro, and terminal, with no Windows platform signal in the supplied project data.
  • Even though Qt6 itself can be cross-platform, the README does not establish that qtermwidget, the QML interface, or GLSL effects are packaged, tested, or supported on Windows.

Under a Windows-only deployment constraint, adoption would introduce undocumented porting and validation work. The README also does not identify a maintained Windows port or a reproducible Windows build process.

  • README, “Description”: "This terminal emulator works under Linux and macOS and requires Qt6."
  • README, “Install”: "latest AppImage (Linux) or dmg (macOS)"
  • Project data: topics are linux, macos, qml, qt, retro, and terminal
Not stated in the README:The README does not say whether unofficial builds or experimental Windows ports exist.;The README does not document Windows compatibility for qtermwidget, GLSL effects, or terminal sessions.
Yes I mainly use the command line on Ubuntu, Fedora, and Arch. I want to install a terminal with CRT visuals that still runs ordinary command-line programs. Is cool-retro-term suitable?
For: A command-line developer working on Ubuntu, Fedora, or Arch who wants a CRT-style terminal without manually configuring desktop effects

Yes, because it is a full terminal emulator rather than a static theme, and it has a straightforward installation path for these Linux distributions.

  • The README description says it mimics the look and feel of old cathode tube screens while remaining customizable and reasonably lightweight.
  • The Install section states that Ubuntu, Fedora, Arch, and most other distributions already package cool-retro-term officially.
  • Colors, fonts, and effects are configurable through the context menu, with Amber, IBM DOS, and Default Green presets shown in the README.
  • Terminal functionality is based on the QML port of Konsole’s qtermwidget, so the project is not merely a screenshot or visual overlay.

The decision is less clear for prolonged log reading: strong scanlines or glow may reduce clarity. The README does not specify resource consumption, readability measurements, or package versions for each distribution.

  • README, “Description”: "cool-retro-term is a terminal emulator which mimics the look and feel of the old cathode tube screens."
  • README, “Install”: "most distributions such as Ubuntu, Fedora or Arch already package cool-retro-term in their official repositories."
  • README, “Description”: "Settings such as colors, fonts, and effects can be accessed via context menu."
  • Project insight: terminal functionality depends on qmltermwidget; project topics include linux and terminal
Not stated in the README:The README does not specify the package version available for Ubuntu, Fedora, or Arch.;The README does not quantify CPU or GPU usage for scanline and glow effects.
Yes I use macOS for terminal demos and recordings. I do not want to build from Qt6 source; I only want a DMG and the ability to switch among Amber, IBM DOS, and Default Green. Does this project meet my constraints?
For: A macOS developer making demos and recordings who needs a directly distributable DMG and switchable retro presets

Yes, because the README explicitly provides a macOS DMG and treats retro presets and visual parameters as end-user features.

  • The Install section says the latest version can be obtained from the Releases page as a macOS dmg, so source compilation is not required by default.
  • The README header shows Default Amber, IBM DOS, and Default Green presets, which fit quick visual changes during demonstrations.
  • Colors, fonts, and effects are available from the right-click context menu, so recording preparation does not require source changes.
  • The Description calls the project eye-candy, customizable, and reasonably lightweight, matching demo and themed-desktop use cases.

There is still release risk: the latest release is 2.0.0-beta2 and the project has five releases. The README does not state whether the DMG is signed or notarized, nor which macOS versions are supported.

  • README, “Install”: "grab the latest AppImage (Linux) or dmg (macOS)."
  • README presets: "Default Amber", "IBM DOS", and "Default Green"
  • README, “Description”: "Settings such as colors, fonts, and effects can be accessed via context menu."
  • Project data: latest_release is 2.0.0-beta2; release_count is 5
Not stated in the README:The README does not say whether the DMG is signed or notarized by macOS.;The README does not list the supported macOS version range.
It depends I already maintain Qt6, QML, and C++ applications and want to add GLSL scanline or glow effects. Is cool-retro-term’s technology stack and build entry point suitable for extending directly?
For: A developer maintaining a Qt6/QML/C++ application who plans to modify the terminal UI and add GLSL display effects

It depends: the stack matches the intended work well, but the README delegates the complete build requirements and platform details to the wiki.

  • Project data identifies QML as the main language and also lists C++, GLSL, and QMake, matching work on QML UI, C++ logic, and shader-based effects.
  • The README requires Qt6 and says the project uses the QML port of Konsole’s qtermwidget, so extending it requires understanding that terminal component’s boundary.
  • The Building section only points to separate Linux and macOS wiki instructions; it does not provide a copy-ready build command in the README.
  • The context menu exposes visual settings, indicating an existing configuration entry point, but the README does not promise a plugin API or stable theme-extension interface.

A Qt6/QML maintainer therefore has a plausible entry point. Before planning an independently distributed extension, the wiki’s dependencies, QMake setup, and rendering pipeline still need to be checked.

  • Project data: main_language is QML; language_distribution includes QML, C++, GLSL, and QMake
  • README, “Description”: "It uses the QML port of qtermwidget (Konsole)"
  • README, “Building”: "Check out the wiki and follow the instructions"
  • README, “Description”: "Settings such as colors, fonts, and effects can be accessed via context menu."
Not stated in the README:The README does not provide the complete Qt6 dependency list, QMake command, or GLSL extension interface.;The README does not specify the qtermwidget version or the compatibility boundary for terminal sessions.
It depends I spend long periods coding and reading logs on Linux or macOS. I still need a full terminal, but I care more about font sharpness and reading comfort than retro visuals. Is cool-retro-term suitable as my primary terminal?
For: A developer on Linux or macOS who writes code and reads logs for long periods and prioritizes text clarity over retro visuals

It depends: it can provide a usable Linux/macOS terminal, but its main value is CRT presentation rather than maximum clarity or information density.

  • The README describes it as mimicking old cathode tube screens and emphasizes that it is eye-candy, making visual presentation a primary product goal.
  • Colors, fonts, and effects can be changed through the context menu, so users can reduce visual intensity; however, the README does not describe a dedicated high-readability or accessibility mode.
  • Its qtermwidget-based architecture supports a real terminal-emulator use case rather than a screenshot-only visual overlay.
  • The latest release is 2.0.0-beta2 and the project has five releases, so the available stability evidence is limited for a tool used every day.

For prolonged log reading, exact character recognition, or remote terminal work, the effect of retro rendering on sharpness and comfort must be checked separately. The README provides no font-rendering, performance, or accessibility test data.

  • README, “Description”: "mimics the look and feel of the old cathode tube screens" and "eye-candy"
  • README, “Description”: "Settings such as colors, fonts, and effects can be accessed via context menu."
  • README, “Description”: "It uses the QML port of qtermwidget (Konsole)"
  • Project data: latest_release is 2.0.0-beta2; release_count is 5
Not stated in the README:The README does not state whether a dedicated high-contrast, accessibility, or fully disabled-CRT mode exists.;The README provides no data on font sharpness, frame rate, or resource usage under different effects.
It depends I need to run a terminal in Linux or macOS remote-desktop environments, but graphics drivers and GLSL rendering conditions vary. Under this constraint, should I standardize on cool-retro-term?
For: An operations engineer deploying a terminal in Linux/macOS remote-desktop environments with uncertain graphics drivers and a requirement for stable rendering

It depends: the supported operating systems match, but the Qt6/QML graphical stack and GLSL-related code make remote-rendering reliability impossible to establish from the README alone.

  • The README requires Qt6 and identifies Linux and macOS as supported platforms, so the base platform requirement is aligned.
  • Project data lists QML, C++, GLSL, and QMake, indicating that deployment involves graphical UI and shader-related implementation in addition to terminal sessions.
  • The context menu exposes colors, fonts, and effects, but the README does not explain how to disable all effects when hardware acceleration or remote display support is limited.
  • Linux AppImage and macOS DMG provide convenient distribution artifacts, but a prebuilt package does not prove compatibility with remote rendering environments.

If stable display is mandatory, the documentation is insufficient for a direct standardization decision. It does not list GPU-driver requirements, OpenGL/GLSL versions, remote-desktop limitations, or a software-rendering fallback.

  • README, “Description”: "works under Linux and macOS and requires Qt6."
  • Project data: language_distribution includes QML, C++, GLSL, and QMake
  • README, “Description”: "Settings such as colors, fonts, and effects can be accessed via context menu."
  • README, “Install”: "latest AppImage (Linux) or dmg (macOS)"
Not stated in the README:The README does not specify minimum GPU, driver, or OpenGL/GLSL versions.;The README does not document behavior under remote desktops, software rendering, or absent hardware acceleration.

✨ Highlights

  • 26,226 stars; focused on recreating cathode-ray tube screens
  • Built on QML qtermwidget with configurable colors, fonts, and effects
  • Provides an AppImage for Linux and a dmg package for macOS
  • The latest release is 2.0.0-beta2 among 5 total releases

🔧 Engineering

  • A terminal emulator that mimics cathode-ray tube appearance and feel with retro styles
  • Adjusts colors, fonts, and visual effects through a context menu without editing config files
  • Uses QML qtermwidget and Qt6, running on Linux and macOS

⚠️ Risks

  • The README only states Linux and macOS support and provides no Windows support information
  • The project requires Qt6, but the README does not specify a Qt6 version or dependency list
  • The latest version is marked 2.0.0-beta2, while stability information is not provided

👥 For who?

  • Users on Linux or macOS who want a terminal with cathode-ray tube visuals
  • Developers using Qt6, QML, or C++ who want to study terminal UI implementation