2017-09-06 09:48:01 +02:00
# cool-retro-term
2014-07-11 02:16:10 +02:00
2017-10-30 00:07:24 +01:00
|> Default Amber|C:\ IBM DOS|$ Default Green|
|---|---|---|
|![Default Amber Cool Retro Term](https://user-images.githubusercontent.com/121322/32070717-16708784-ba42-11e7-8572-a8fcc10d7f7d.gif)|![IBM DOS](https://user-images.githubusercontent.com/121322/32070716-16567e5c-ba42-11e7-9e64-ba96dfe9b64d.gif)|![Default Green Cool Retro Term](https://user-images.githubusercontent.com/121322/32070715-163a1c94-ba42-11e7-80bb-41fbf10fc634.gif)|
2017-09-06 09:48:01 +02:00
## Description
2014-09-03 22:19:34 +02:00
cool-retro-term is a terminal emulator which mimics the look and feel of the old cathode tube screens.
2013-12-28 18:04:35 +01:00
It has been designed to be eye-candy, customizable, and reasonably lightweight.
2015-01-24 18:54:08 +01:00
It uses the QML port of qtermwidget (Konsole) developed by me: https://github.com/Swordfish90/qmltermwidget .
2014-07-11 02:16:10 +02:00
2017-10-30 00:04:23 +01:00
This terminal emulator works under Linux and macOS and requires Qt 5.2 or higher.
2014-07-11 02:16:10 +02:00
2017-09-06 09:48:01 +02:00
## Screenshots
2018-12-18 23:40:24 +01:00
![Image ](<https://i.imgur.com/TNumkDn.png> )
![Image ](<https://i.imgur.com/hfjWOM4.png> )
![Image ](<https://i.imgur.com/GYRDPzJ.jpg> )
2014-07-11 02:16:10 +02:00
2018-11-24 02:13:39 +01:00
## Install
Walk the easy way and install cool-retro-term using one of these convenient packages:
2014-08-13 03:43:01 +02:00
2019-01-22 21:49:21 +01:00
Just grab the latest AppImage from the release page and make it executable and run it:
wget https://github.com/Swordfish90/cool-retro-term/releases/download/1.1.1/Cool-Retro-Term-1.1.1-x86_64.AppImage
chmod a+x Cool-Retro-Term-1.1.1-x86_64.AppImage
./Cool-Retro-Term-1.1.1-x86_64.AppImage
2019-02-17 15:32:08 +01:00
**Fedora** has the `cool-retro-term` in the official repositories. All you have to do is `sudo dnf install cool-retro-term` .
2017-12-12 00:37:25 +01:00
2018-11-24 02:13:39 +01:00
Users of **openSUSE** can grab a package from [Open Build Service ](http://software.opensuse.org/package/cool-retro-term ).
2014-08-13 03:43:01 +02:00
2018-11-24 02:13:39 +01:00
**Arch** users can install this [package ](https://aur.archlinux.org/packages/cool-retro-term-git/ ) directly via the [AUR ](https://aur.archlinux.org ):
2014-08-13 03:43:01 +02:00
2014-09-03 22:19:34 +02:00
yaourt -S aur/cool-retro-term-git
2014-08-13 03:43:01 +02:00
2015-05-18 18:03:30 +02:00
or use:
pacman -S cool-retro-term
to install precompiled from community repository.
2019-04-01 21:02:15 +02:00
**Gentoo** users can now install the fourth release "1.1.1" from a 3rd-party repository preferably via layman:
2014-12-03 13:47:37 +01:00
2017-08-27 19:50:24 +02:00
USE="git" emerge app-portage/layman
2016-03-13 21:42:13 +01:00
wget https://www.gerczei.eu/files/gerczei.xml -O /etc/layman/overlays/gerczei.xml
2017-08-27 19:50:24 +02:00
layman -f -a qt -a gerczei # those who've added the repo before 27/08/17 should remove, update and add it again as its source has changed
2019-04-01 21:02:15 +02:00
ACCEPT_KEYWORDS="~*" emerge =x11-terms/cool-retro-term-1.1.1::gerczei
2015-02-15 14:28:16 +01:00
2015-08-14 15:45:51 +02:00
The live ebuild (version 9999-r1) tracking the bleeding-edge WIP codebase also remains available.
2014-12-03 14:06:48 +01:00
A word of warning: USE flags and keywords are to be added to portage's configuration files and every emerge operation should be executed with '-p' (short option for --pretend) appended to the command line first as per best practice!
2014-12-03 13:47:37 +01:00
2018-11-24 02:13:39 +01:00
Users of **Ubuntu 14.04 LTS (Trusty) up to 15.10 (Wily)** can use [this PPA ](https://launchpad.net/~bugs-launchpad-net-falkensweb ).
2015-01-10 17:54:23 +01:00
2018-11-24 02:13:39 +01:00
**Ubuntu 17.10** can use [this PPA ](https://launchpad.net/%7Evantuz/+archive/ubuntu/cool-retro-term )
2015-01-10 17:54:23 +01:00
2019-02-01 14:09:17 +01:00
**Solus** users can install using `eopg` :
```
eopkg it cool-retro-term
```
2019-04-16 11:27:22 +02:00
**macOS** users can grab the latest dmg from the [release page ](https://github.com/Swordfish90/cool-retro-term/releases ) or install via Homebrew:
```
brew cask install cool-retro-term
```
2015-01-24 18:54:08 +01:00
2019-02-12 10:44:58 +01:00
**FreeBSD** users can install cool-retro-term with `pkg` :
pkg install cool-retro-term
## Build instructions (FreeBSD)
Grab a copy of [the FreeBSD Ports Collection ](https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html ), modify [`/usr/ports/x11/cool-retro-term/Makefile` ](https://svnweb.freebsd.org/ports/head/x11/cool-retro-term/Makefile?view=markup ) as you like, and then run `make install` to build and install the emulator:
```
cd /usr/ports/x11/cool-retro-term
make install
```
2017-09-06 09:48:01 +02:00
## Build instructions (Linux)
2014-07-31 14:01:46 +02:00
2018-11-24 02:13:39 +01:00
Build cool-retro-term yourself, you know, the retro way.
2017-09-06 09:48:01 +02:00
## Dependencies
2014-07-31 14:01:46 +02:00
Make sure to install these first.
---
**Ubuntu 14.04**
2014-07-11 02:16:10 +02:00
sudo apt-get install build-essential qmlscene qt5-qmake qt5-default qtdeclarative5-dev qtdeclarative5-controls-plugin qtdeclarative5-qtquick2-plugin libqt5qml-graphicaleffects qtdeclarative5-dialogs-plugin qtdeclarative5-localstorage-plugin qtdeclarative5-window-plugin
2014-07-31 14:01:46 +02:00
---
2016-12-06 04:11:50 +01:00
**Ubuntu 16.10**
2016-12-06 04:44:47 +01:00
sudo apt-get install build-essential qmlscene qt5-qmake qt5-default qtdeclarative5-dev qml-module-qtquick-controls qtdeclarative5-qtquick2-plugin libqt5qml-graphicaleffects qml-module-qtquick-dialogs qtdeclarative5-localstorage-plugin qtdeclarative5-window-plugin
2016-12-06 04:11:50 +01:00
---
2017-09-09 19:31:11 +02:00
**Ubuntu 17.04**
2018-01-02 17:45:08 +01:00
sudo apt install build-essential libqt5qml-graphicaleffects qml-module-qt-labs-folderlistmodel qml-module-qt-labs-settings qml-module-qtquick-controls qml-module-qtquick-dialogs qmlscene qt5-default qt5-qmake qtdeclarative5-dev qtdeclarative5-localstorage-plugin qtdeclarative5-qtquick2-plugin qtdeclarative5-window-plugin
2017-09-09 19:31:11 +02:00
---
2017-12-12 15:24:20 +01:00
**Ubuntu 17.10**
sudo apt-get install build-essential qml-module-qtgraphicaleffects qml-module-qt-labs-folderlistmodel qml-module-qt-labs-settings qml-module-qtquick-controls qml-module-qtquick-dialogs qmlscene qt5-default qt5-qmake qtdeclarative5-dev qtdeclarative5-localstorage-plugin qtdeclarative5-qtquick2-plugin qtdeclarative5-window-plugin
---
2018-08-22 08:15:02 +02:00
**Debian Jessie and above**
2014-07-31 14:01:46 +02:00
2018-08-22 08:15:02 +02:00
sudo apt install build-essential qmlscene qt5-qmake qt5-default qtdeclarative5-dev qml-module-qtquick-controls qml-module-qtgraphicaleffects qml-module-qtquick-dialogs qml-module-qtquick-localstorage qml-module-qtquick-window2 qml-module-qt-labs-settings qml-module-qt-labs-folderlistmodel
2014-07-30 05:40:29 +02:00
2014-07-31 14:01:46 +02:00
---
2014-07-31 20:40:06 +02:00
**Fedora**
This command should install the known fedora dependencies:
2014-10-11 13:20:23 +02:00
2016-01-30 05:44:41 +01:00
sudo yum -y install qt5-qtbase qt5-qtbase-devel qt5-qtdeclarative qt5-qtdeclarative-devel qt5-qtgraphicaleffects qt5-qtquickcontrols redhat-rpm-config
2014-10-11 13:20:23 +02:00
2014-07-31 20:40:06 +02:00
or:
2014-10-11 13:20:23 +02:00
2016-01-30 05:44:41 +01:00
sudo dnf -y install qt5-qtbase qt5-qtbase-devel qt5-qtdeclarative qt5-qtdeclarative-devel qt5-qtgraphicaleffects qt5-qtquickcontrols redhat-rpm-config
2014-10-11 13:20:23 +02:00
2014-07-31 20:40:06 +02:00
---
2014-07-31 14:01:46 +02:00
**Arch Linux**
2014-07-11 02:16:10 +02:00
sudo pacman -S qt5-base qt5-declarative qt5-quickcontrols qt5-graphicaleffects
2014-07-30 11:18:29 +02:00
2014-07-31 14:01:46 +02:00
---
2014-08-01 00:45:38 +02:00
**openSUSE**
2014-08-01 16:38:29 +02:00
Add repository with latest Qt 5 (this is only needed on openSUSE 13.1, Factory already has it):
2014-08-01 00:45:38 +02:00
sudo zypper ar http://download.opensuse.org/repositories/KDE:/Qt5/openSUSE_13.1/ KDE:Qt5
2014-08-01 16:38:29 +02:00
Install dependencies:
2014-08-01 00:45:38 +02:00
sudo zypper install libqt5-qtbase-devel libqt5-qtdeclarative-devel libqt5-qtquickcontrols libqt5-qtgraphicaleffects
---
2014-07-31 14:01:46 +02:00
**Anyone else**
2014-07-11 02:16:10 +02:00
Install Qt directly from here http://qt-project.org/downloads . Once done export them in you path (replace "_/opt/Qt5.3.1/5.3/gcc_64/bin_" with your correct folder):
export PATH=/opt/Qt5.3.1/5.3/gcc_64/bin/:$PATH
2014-10-11 13:20:23 +02:00
---
2013-12-28 18:04:35 +01:00
2017-09-06 09:48:01 +02:00
### Compile
2014-07-31 14:01:46 +02:00
Once you installed all dependencies (Qt is installed and in your path) you need to compile and run the application:
2013-12-28 18:04:35 +01:00
2014-07-31 14:05:28 +02:00
```bash
# Get it from GitHub
2014-11-12 23:27:38 +01:00
git clone --recursive https://github.com/Swordfish90/cool-retro-term.git
2014-07-31 14:05:28 +02:00
# Build it
2014-09-03 22:19:34 +02:00
cd cool-retro-term
2014-08-08 15:11:53 +02:00
# Compile (Fedora and OpenSUSE user should use qmake-qt5 instead of qmake)
2014-09-03 21:33:08 +02:00
qmake & & make
2014-07-31 14:05:28 +02:00
# Have fun!
2014-09-03 22:19:34 +02:00
./cool-retro-term
2014-07-31 14:05:28 +02:00
```
2014-10-11 13:20:23 +02:00
2017-10-30 00:04:23 +01:00
## Build instructions (macOS)
2014-10-11 13:20:23 +02:00
2014-12-19 06:17:47 +01:00
1. Install [Xcode ](https://developer.apple.com/xcode/ ) and agree to the licence agreement
2. Enter the following commands into the terminal:
2015-02-23 21:34:47 +01:00
**Brew**
2014-12-19 06:17:47 +01:00
```sh
brew install qt5
git clone --recursive https://github.com/Swordfish90/cool-retro-term.git
export CPPFLAGS="-I/usr/local/opt/qt5/include"
export LDFLAGS="-L/usr/local/opt/qt5/lib"
export PATH=/usr/local/opt/qt5/bin:$PATH
cd cool-retro-term
qmake & & make
mkdir cool-retro-term.app/Contents/PlugIns
cp -r qmltermwidget/QMLTermWidget cool-retro-term.app/Contents/PlugIns
open cool-retro-term.app
```
2014-10-11 13:20:23 +02:00
2015-02-23 21:34:47 +01:00
**MacPorts**
```sh
2016-02-18 17:47:16 +01:00
sudo port install qt5
2015-02-23 21:34:47 +01:00
git clone --recursive https://github.com/Swordfish90/cool-retro-term.git
cd cool-retro-term
2016-02-18 17:47:16 +01:00
/opt/local/libexec/qt5/bin/qmake & & make
2015-02-23 21:34:47 +01:00
mkdir cool-retro-term.app/Contents/PlugIns
cp -r qmltermwidget/QMLTermWidget cool-retro-term.app/Contents/PlugIns
open cool-retro-term.app
```
2019-11-25 17:20:36 +01:00
**Homebrew**
```sh
brew cask install cool-retro-term
```
2017-09-06 09:48:01 +02:00
## Donations
2017-12-22 06:17:45 +01:00
I made this project in my spare time because I love what I'm doing. If you are enjoying it and you want to buy me a beer click [here ](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=flscogna%40gmail%2ecom&lc=IT&item_name=Filippo%20Scognamiglio¤cy_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted ).
2015-01-25 11:29:25 +01:00
You can also add "bounties" on your favourite issues. More information on the [Bountysource ](https://www.bountysource.com/teams/crt/issues ) page.