cool-retro-term/README.md
tgerczei d3d153b9c0 Update README.md
layman syntax correction
2014-12-13 08:16:36 +01:00

4.4 KiB

#cool-retro-term

##Description cool-retro-term is a terminal emulator which mimics the look and feel of the old cathode tube screens. It has been designed to be eye-candy, customizable, and reasonably lightweight.

It uses the QML port of qtermwidget (Konsole) developed by me: https://github.com/Swordfish90/qmltermwidget

This terminal emulator requires Qt 5.2 or higher to run.

##Screenshots Image Image Image

##Get cool-retro-term You can either build cool-retro-term yourself (see below) or walk the easy way and install one of these packages:

Users of Fedora and openSUSE can grab a package from Open Build Service.

Arch users can install this package directly via the AUR:

yaourt -S aur/cool-retro-term-git

Gentoo users can install from a 3rd-party repository preferably via layman:

# USE="subversion git" emerge app-portage/layman
# wget --no-check-certificate https://www.gerczei.eu/files/gerczei.xml -O /etc/layman/overlays/gerczei.xml
# layman -f -a qt -a gerczei
# ACCEPT_KEYWORDS="~*" emerge x11-terms/cool-retro-term::gerczei

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!

##Build instructions (Linux)

##Dependencies Make sure to install these first.


Ubuntu 14.04

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

Debian Jessie

sudo apt-get 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

Fedora This command should install the known fedora dependencies:

sudo yum -y install qt5-qtbase qt5-qtbase-devel qt5-qtdeclarative qt5-qtdeclarative-devel qt5-qtgraphicaleffects qt5-qtquickcontrols

or:

sudo dnf -y install qt5-qtbase qt5-qtbase-devel qt5-qtdeclarative qt5-qtdeclarative-devel qt5-qtgraphicaleffects qt5-qtquickcontrols

Arch Linux

sudo pacman -S qt5-base qt5-declarative qt5-quickcontrols qt5-graphicaleffects

openSUSE

Add repository with latest Qt 5 (this is only needed on openSUSE 13.1, Factory already has it):

sudo zypper ar http://download.opensuse.org/repositories/KDE:/Qt5/openSUSE_13.1/ KDE:Qt5

Install dependencies:

sudo zypper install libqt5-qtbase-devel libqt5-qtdeclarative-devel libqt5-qtquickcontrols libqt5-qtgraphicaleffects

Anyone else

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

###Compile Once you installed all dependencies (Qt is installed and in your path) you need to compile and run the application:

# Get it from GitHub
git clone --recursive https://github.com/Swordfish90/cool-retro-term.git

# Build it
cd cool-retro-term

# Compile (Fedora and OpenSUSE user should use qmake-qt5 instead of qmake)
qmake && make

# Have fun!
./cool-retro-term

##Build instructions (OSX)

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

##Donations 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 .