mirror of
https://github.com/kovidgoyal/kitty.git
synced 2024-11-11 09:52:13 +03:00
88 lines
2.4 KiB
ReStructuredText
88 lines
2.4 KiB
ReStructuredText
kitty - Binary install
|
|
========================
|
|
|
|
.. |ins| replace:: curl -L :literal:`https://sw.kovidgoyal.net/kitty/installer.sh` | sh /dev/stdin
|
|
|
|
.. highlight:: sh
|
|
|
|
You can install pre-built binaries of |kitty| if you are on macOS or Linux using
|
|
the following simple command:
|
|
|
|
.. parsed-literal::
|
|
:class: pre
|
|
|
|
|ins|
|
|
|
|
|
|
The binaries will be installed in the standard location for your OS,
|
|
:file:`/Applications/kitty.app` on macOS and :file:`~/.local/kitty.app` on
|
|
Linux. The installer only touches files in that directory.
|
|
|
|
|
|
Manually installing
|
|
---------------------
|
|
|
|
If something goes wrong or you simply do not want to run the installer, you can
|
|
manually download and install |kitty| from the `GitHub releases page
|
|
<https://github.com/kovidgoyal/kitty/releases>`_. If you are on macOS, download
|
|
the :file:`.dmg` and install as normal. If you are on Linux, download the tarball
|
|
and extract it into a directory. The |kitty| executable will be in the
|
|
:file:`bin` sub-directory.
|
|
|
|
Ubuntu/Debian (Gnome Shell) installing
|
|
---------------------
|
|
|
|
.. code-block:: sh
|
|
|
|
# Install kitty
|
|
curl -L https://sw.kovidgoyal.net/kitty/installer.sh | sh /dev/stdin
|
|
# Create symbolic link
|
|
ln -s ~/.local/kitty.app/bin/kitty ~/.local/bin/
|
|
# Link icon
|
|
sed -i "s/Icon\=kitty/Icon\=\/home\/$USER\/.local\/kitty.app\/share\/icons\/hicolor\/256x256\/apps\/kitty.png/g" ~/.local/kitty.app/share/applications/kitty.desktop
|
|
# Create desktop icons in GNOME SHELL
|
|
cp ~/.local/kitty.app/share/applications/kitty.desktop ~/.local/share/applications
|
|
|
|
|
|
|
|
Customizing the installation
|
|
--------------------------------
|
|
|
|
* You can specify a different install location, with ``dest``:
|
|
|
|
.. parsed-literal::
|
|
:class: pre
|
|
|
|
|ins| \\
|
|
dest=/some/other/location
|
|
|
|
* You can tell the installer not to launch |kitty| after installing it with
|
|
``launch=n``:
|
|
|
|
.. parsed-literal::
|
|
:class: pre
|
|
|
|
|ins| \\
|
|
launch=n
|
|
|
|
* You can use a previously downloaded dmg/tarball, with ``installer``:
|
|
|
|
.. parsed-literal::
|
|
:class: pre
|
|
|
|
|ins| \\
|
|
installer=/path/to/dmg or tarball
|
|
|
|
Uninstalling
|
|
----------------
|
|
|
|
All the installer does is copy the kitty files into the install directory
|
|
(defaults to :file:`~/.local/kitty.app`). To uninstall, simply delete that
|
|
directory.
|
|
|
|
|
|
Building from source
|
|
------------------------
|
|
|
|
|kitty| is easy to build from source, follow the :doc:`instructions <build>`.
|