4719eefa4d
fixes #98
113 lines
5.0 KiB
Markdown
113 lines
5.0 KiB
Markdown
Installing Terminator
|
|
=====================
|
|
|
|
It's strongly recommended to install Terminator using your OS's package
|
|
system rather than using setup.py yourself.
|
|
|
|
Packages are known to be available under the name "terminator" under a
|
|
lot of distributions, see below for a list.
|
|
|
|
## Source Install
|
|
|
|
If you can't use distribution packages, make sure you satisfy Terminator's
|
|
dependencies yourself:
|
|
|
|
**Python 3.5+ recommended:** `python3` or `python37` (in FreeBSD)
|
|
|
|
**Python GTK and VTE bindings:**
|
|
|
|
Fedora/CentOS: python3-gobject python3-configobj python3-psutil vte291
|
|
keybinder3 intltool gettext
|
|
Debian/Ubuntu: python3-gi python3-psutil python3-configobj
|
|
gir1.2-keybinder-3.0 gettext intltool dbus-x11
|
|
FreeBSD: py37-psutil py37-configobj keybinder-gtk3 py37-gobject3 gettext
|
|
intltool libnotify vte3
|
|
|
|
If you don't care about native language support or icons, Terminator
|
|
should run just fine directly from this directory, just:
|
|
|
|
python3 terminator --help
|
|
|
|
And go from there. Manpages are available in the 'doc' directory.
|
|
|
|
> **Note:** Currently most distributions use `python3` as binaries for Python 3,
|
|
> make sure to update either the shebangs, call the scripts with `python3` or
|
|
> use a wrapper script.
|
|
>
|
|
> Setuptools install will update the scripts with the correct shebang.
|
|
|
|
To install properly, run:
|
|
|
|
python3 setup.py build
|
|
python3 setup.py install --record=install-files.txt
|
|
|
|
See `--help` for an overview of the available options; e.g. `--prefix` to
|
|
install to a custom base directory, and `--without-gettext` to avoid
|
|
installing natural language support files.
|
|
|
|
setup.py supports basic uninstallation provided `--record` was used for
|
|
installation as above:
|
|
|
|
python3 setup.py uninstall --manifest=install-files.txt
|
|
|
|
Note that uninstall will avoid removing most empty directories so it
|
|
won't harm e.g. locale or icon directories which only contain Terminator
|
|
data. It also won't rebuild the icon cache, so you may wish to:
|
|
|
|
gtk-update-icon-cache -q -f ${PREFIX}/share/icons/hicolor
|
|
|
|
Where ${PREFIX} is the base install directory; e.g. /usr/local.
|
|
|
|
## Distributions
|
|
|
|
[![Packaging status](https://repology.org/badge/tiny-repos/terminator.svg)](https://repology.org/project/terminator/versions)
|
|
|
|
If you maintain terminator for an OS other than these, please get in touch
|
|
or issue a PR to this file.
|
|
|
|
Distribution | Contact | Package Info | Source Code | Bug Tracker |
|
|
-------------|---------|-----|-------------|-------------|
|
|
ArchLinux | [@grazzolini] | [archlinux.org] | [git.archlinux.org] | [bugs.archlinux.org]
|
|
CentOS EPEL | [@mattrose], [@dmaphy] | | [src.fedoraproject.org/branches]
|
|
Debian | [@lazyfrosch] | [tracker.debian.org] | [salsa.debian.org] | [bugs.debian.org]
|
|
Fedora | [@mattrose], [@dmaphy] | | [src.fedoraproject.org] | [bugzilla.redhat.com]
|
|
FreeBSD | | [freshports.org] | [svnweb.freebsd.org] | [bugs.freebsd.org]
|
|
Gentoo | [@DarthGandalf] | [packages.gentoo.org] | [gitweb.gentoo.org] | [bugs.gentoo.org]
|
|
OpenSUSE | | [build.opensuse.org] |
|
|
Ubuntu | copied from Debian | [launchpad.net/ubuntu] | | [bugs.launchpad.net]
|
|
|
|
[@lazyfrosch]: https://github.com/lazyfrosch
|
|
[tracker.debian.org]: https://tracker.debian.org/pkg/terminator
|
|
[salsa.debian.org]: https://salsa.debian.org/python-team/applications/terminator
|
|
[bugs.debian.org]: https://bugs.debian.org/cgi-bin/pkgreport.cgi?repeatmerged=no&src=terminator
|
|
|
|
[@mattrose]: https://github.com/mattrose
|
|
[@dmaphy]: https://github.com/dmaphy
|
|
[src.fedoraproject.org]: https://src.fedoraproject.org/rpms/terminator
|
|
[src.fedoraproject.org/branches]: https://src.fedoraproject.org/rpms/terminator/branches
|
|
[bugzilla.redhat.com]: https://bugzilla.redhat.com/buglist.cgi?component=terminator&product=Fedora
|
|
|
|
[launchpad.net/ubuntu]: https://launchpad.net/ubuntu/+source/terminator
|
|
[bugs.launchpad.net]: https://bugs.launchpad.net/ubuntu/+source/terminator/+bugs
|
|
|
|
[@grazzolini]: https://github.com/grazzolini
|
|
[archlinux.org]: https://www.archlinux.org/packages/community/any/terminator/
|
|
[git.archlinux.org]: https://git.archlinux.org/svntogit/community.git/tree/trunk?h=packages/terminator
|
|
[bugs.archlinux.org]: https://bugs.archlinux.org/?project=5&string=terminator
|
|
|
|
[@DarthGandalf]: https://github.com/DarthGandalf
|
|
[packages.gentoo.org]: https://packages.gentoo.org/packages/x11-terms/terminator
|
|
[gitweb.gentoo.org]: https://gitweb.gentoo.org/repo/gentoo.git/tree/x11-terms/terminator
|
|
[bugs.gentoo.org]: https://bugs.gentoo.org/buglist.cgi?quicksearch=x11-terms%2Fterminator
|
|
|
|
[build.opensuse.org]: https://build.opensuse.org/package/show/X11:terminals/terminator
|
|
|
|
[svnweb.freebsd.org]: https://svnweb.freebsd.org/ports/head/x11/terminator
|
|
[freshports.org]: https://freshports.org/x11/terminator
|
|
[bugs.freebsd.org]: https://bugs.freebsd.org/bugzilla/buglist.cgi?quicksearch=terminator
|
|
|
|
A more extensive list can be found on Repology:
|
|
|
|
[![Packaging status](https://repology.org/badge/vertical-allrepos/terminator.svg)](https://repology.org/project/terminator/versions)
|
|
|