mrkeyoor.com_
Sun 13 Sept 16:46 UTC
Dev Toolsevaluationupdated 13 Sept 2026

cool-retro-term review

cool-retro-term is a terminal emulator for Linux and macOS that makes a live shell look like an old cathode-ray tube display. Colors, fonts, screen curvature, glow, and other effects are adjustable from its settings. The shell underneath stays familiar; the visual treatment is the reason to install it.

trackingstars / 7d
Verdict

Our cool-retro-term sandbox installed 35 packages in 14 seconds and built in 5 seconds, but the checkout supplied no test target. Use a packaged build if you want its CRT effects, because the Qt6 application and Qt5 build wiki currently disagree. It is a fun second terminal for Linux or a compatible Mac; current graphics and keyboard reports make it harder to recommend as the only terminal on a work machine.

We ran it

Lab card: what happened when we ran cool-retro-termScreenshot of cool-retro-term (github.com/Swordfish90/cool-retro-term)
Install✓ · 14s35 packages · 37 MB
Build✓ · 5s
Testsn/ano test script
Known vulns0(pip-audit)
Repo485 files~37,041 lines of source · 57.9 MB · 1 CI workflows

Answers from our run

Does cool-retro-term build from source?

Dependencies installed in 14 seconds (35 packages), and the build succeeded in 5 seconds. We cloned commit 1394ce8 into a clean Debian container with 3 CPUs and no project-specific setup.

Does cool-retro-term have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does cool-retro-term have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use cool-retro-term?

Windows users: the README limits support to Linux and macOS.

What are the alternatives to cool-retro-term?

Ghostty, Alacritty, kitty. Our cool-retro-term sandbox installed 35 packages in 14 seconds and built in 5 seconds, but the checkout supplied no test target.

Setup3/5Packages are easy; source instructions still point to Qt5
Docs2/5The short README says Qt6 while its build wiki says Qt5
Community4/526,143 stars, a May 2026 release, and recent issue activity
Maturity3/5Long-lived terminal, but beta builds and platform bugs remain

Who it’s for

Developers who want a working terminal with a strong CRT look for occasional use, demos, or themed workspaces.
Linux and Apple Silicon Mac users who prefer a packaged AppImage, DMG, or distribution build.
QML and Qt developers interested in a graphical terminal built over qmltermwidget.
Users willing to trade some daily-driver predictability for deep control over fonts, colors, and display effects.

Who it’s NOT for

Windows users: the README limits support to Linux and macOS.
Source builders who need copy-and-paste-current instructions: the README requires Qt6, while the linked Linux and macOS wiki pages still prescribe Qt5; open issue 928 asks for that mismatch to be fixed.
AMD Wayland users who cannot tolerate a launch crash: issue 934 reports a SIGABRT with Qt6, EGL, Mesa 25.3.5, and an AMD Renoir GPU.
Intel Mac owners expecting the current download to cover x86_64: open issue 973 asks for that support or matching build instructions.
Mac users whose workflow depends on Option-generated characters with non-US layouts: issue 962 reports an unwanted Escape prefix with a Norwegian keyboard.

Setup reality

Our sandbox install succeeded in 14 seconds, adding 35 packages and using 37 MB on disk. The build succeeded in 5 seconds. No test script or target was present, so tests were skipped; pip-audit found 0 known vulnerabilities.

No account, hosted service, or credential is required. The README recommends a release AppImage or DMG, and says many Linux distributions package the app. A source checkout needs Qt6 and the qmltermwidget submodule, although the linked build wiki still lists Qt5 commands and dependencies.

Only Linux and macOS are supported. Rendering depends on Qt and the local graphics stack, and current issues describe crashes on some Mesa and Wayland combinations. Our measured build did not supply a test target, so it offers no automated evidence about keyboard handling, rendering, resizing, or a real interactive shell session.

Three README demos make the CRT effect the whole point

The README opens with 3 terminal demos: amber, IBM DOS, and green. cool-retro-term wraps a real shell in a QML interface that imitates an old cathode-ray tube. Fonts, colors, glow, curvature, scan lines, and related effects can be changed from the context menu. It uses the QML port of qtermwidget, itself based on Konsole's terminal component, so commands still run in a terminal emulator rather than in a decorative text box.

The visual idea has more code behind it than the short README suggests. Our checkout held 485 files, about 37,041 source lines, and 57.9 MB before installation. That includes application code, QML effects, fonts, presets, packaging material, and the terminal widget submodule. The size makes sense for a desktop program with bundled visual assets. It also means a user who only wants green text on black can get a lighter result by theming an existing terminal.

What happened when we ran it

Our sandbox installed 35 packages in 14 seconds and occupied 37 MB on disk. The build then succeeded in 5 seconds. Pip-audit found 0 known vulnerabilities in the installed Python packages. Our measurement method used commit 1394ce8 in a fresh unprivileged Debian container with 3 CPUs and 8 GB of RAM. Those results establish that the lab's setup and build steps completed; they do not measure launch time, typing latency, animation speed, or terminal rendering.

The repository provided no test script or target, so our test step was skipped. Its 485-file checkout had 1 CI workflow, no Dockerfile, and no tests directory. A successful build is useful, but it cannot catch keyboard mappings, terminal escape handling, window-state problems, or graphics-driver crashes. The absence of a runnable suite is especially relevant here because most of the product's value appears inside a GUI and depends on Qt plus the host display stack.

Qt6 in the README conflicts with Qt5 in both build guides

The 57.9 MB checkout's current README says Linux and macOS support requires Qt6. It sends source builders to 2 wiki pages, one for each platform. Both pages still install Qt5, set Qt5 paths, and invoke qmake; the Linux page names packages such as qt5-qmake, while the macOS page points to Qt 5.15.2. Open issue 928 identifies the same contradiction and says some systems need qmake6. That is a documentation defect a builder will meet before touching the application code.

Packaged installation avoids most of that confusion. Release 2.0.0-beta2, published on May 31, 2026, provides an AppImage and a macOS DMG. The README also points Linux users to distribution packages, and the macOS wiki names Homebrew and MacPorts. None of these routes needs an online account or service credential. A package is therefore the sensible first trial. Build from source when you need to modify QML, qmltermwidget, or platform integration, and verify every Qt dependency yourself.

Qt6 and Mesa reports make graphics compatibility a local test

Open issue 934 describes a launch-time SIGABRT on an AMD Renoir system using Mesa 25.3.5, Qt6, EGL, and Wayland under Hyprland. Issue 958 reports an intermittent QSG render-thread segmentation fault on Gentoo with Mesa 26.0.7 after changing profiles or exiting. These are reports tied to particular machines, not proof that every AMD or Wayland setup fails. They do show why the 5-second build cannot answer the question that matters: whether the terminal stays stable on your graphics stack.

Mac compatibility has its own edges. Issue 973, opened September 7, 2026, asks for x86_64 support for current macOS versions or instructions for building on Intel hardware. Issue 962 reports that Option-generated characters on a Norwegian keyboard arrive with an Escape prefix on macOS Tahoe 26.5.1. Issue 950 says Backspace deletes a word in some terminal applications on macOS. Anyone who works through keyboard-driven editors or remote shells should test their actual layout and shortcuts before replacing a dependable terminal.

Release 2.0.0-beta2 is current, while 563 reports remain open

GitHub shows the last push on May 31, 2026, the same day as release 2.0.0-beta2. Its notes mention Linux resize-crash fixes, tab-management shortcuts, and smaller corrections. Issue conversations were still being updated in September 2026, so the project has recent code and user activity. The tag includes beta in its name even though GitHub does not mark the release as a prerelease. Buyers should judge the artifact by that tag and test it on their own desktop.

The repository had 26,143 stars and 563 combined open issues and pull requests when fetched. That combined number is not a count of confirmed defects, and the queue includes old requests. Several current reports are concrete enough to affect a decision: touchpad scrolling described as unusably fast in issue 927, Intel Mac packaging in issue 973, and the Qt5 wiki mismatch in issue 928. Popularity is easy to explain because the terminal looks distinctive. Maintenance capacity appears smaller than the backlog.

Use it as a second terminal before making it the daily driver

A 14-second install and 5-second build make cool-retro-term cheap to inspect, especially through a packaged release. Its best use is a themed workspace, recorded demo, retro-computing setup, or occasional shell where atmosphere matters. The settings expose enough control to make the effect personal instead of locking everyone to one green-screen imitation. Linux and compatible macOS users can try that experience without creating an account or changing their shell.

Daily use asks harder questions than the screenshots answer. The measured commit had no automated test target, the source instructions disagree over Qt5 and Qt6, and current issues reach into graphics, keyboard input, scrolling, and command-line behavior. Keep another terminal installed while checking those paths. Ghostty, Alacritty, and kitty make stronger defaults when predictable platform behavior or deeper terminal workflows outrank the CRT presentation.

Alternatives

ProjectWhat it isPick it when
Ghostty gh↗A cross-platform terminal with native interfaces and GPU rendering.pick this instead when daily use, platform integration, and current development matter more than a CRT simulation.
Alacritty gh↗A cross-platform OpenGL terminal emulator with a restrained feature set.pick this instead when you want a straightforward GPU terminal and can live without built-in retro effects.
kitty gh↗A GPU-based terminal with tabs, layouts, graphics, and extensive keyboard control.pick this instead when terminal features and keyboard workflows matter more than period styling.

What people are saying

  1. [github-trending] Swordfish90/cool-retro-term

Sources

  1. cool-retro-term repository and README
  2. cool-retro-term release 2.0.0-beta2
  3. Linux build instructions
  4. macOS build instructions
  5. Qt6 build instruction issue 928
  6. AMD Wayland crash report 934
  7. Intel macOS support request 973
  8. macOS Option-key report 962

More dev tools reviews

Kingfisher · mypy · act · ligolo-ng · stremio-core · agent-skills · the whole board →