1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87
|
<!--
SPDX-FileCopyrightText: Simon Schneegans <code@simonschneegans.de>
SPDX-License-Identifier: CC-BY-4.0
-->
<p align="center">
<img src ="pics/banner-06.jpg" />
</p>
# Installation
You can either install Fly-Pie from extensions.gnome.org (a), download a stable release
from GitHub (b) or clone the latest version directly with `git` (c).
There may also be some community-maintained packages for your distribution, such as:
* [AUR (Arch): latest Fly-Pie release](https://aur.archlinux.org/packages/gnome-shell-extension-fly-pie)
* [AUR (Arch): directly from git](https://aur.archlinux.org/packages/gnome-shell-extension-fly-pie-git)
## a) Installing from extensions.gnome.org
This is the most easy way to install Fly-Pie. Just head over to
[extensions.gnome.org](https://extensions.gnome.org/extension/3433/fly-pie) and flip the switch!
If you want to use a more up-to-date version of Fly-Pie, you can try one of the methods listed below.
## b) Downloading a Stable Release
Execute this command to download the latest stable release:
```bash
wget https://github.com/Schneegans/Fly-Pie/releases/latest/download/flypie@schneegans.github.com.zip
```
Install it by executing the following command. If you have Fly-Pie already installed and want to upgrade to
the latest version, append the `--force` flag in order to overwrite existing installs of Fly-Pie.
```bash
gnome-extensions install flypie@schneegans.github.com.zip
```
Then restart GNOME Shell with <kbd>Alt</kbd> + <kbd>F2</kbd>, <kbd>r</kbd> + <kbd>Enter</kbd>.
Or logout / login if you are on Wayland.
Then you can enable the extension with the *Gnome Tweak Tool*, the *Extensions* application or with this command:
```bash
gnome-extensions enable flypie@schneegans.github.com
```
## c) Cloning the Latest Version with `git`
You should **not** clone Fly-Pie directly to the `~/.local/share/gnome-shell/extensions` directory as this may get overridden occasionally!
Execute the clone command below where you want to have the source code of Fly-Pie.
```bash
git clone https://github.com/Schneegans/Fly-Pie.git
cd Fly-Pie
```
If your GNOME Shell version is <= 45, you will have to checkout the `gnome-3.36-44` branch:
```bash
git checkout gnome-3.36-44
```
Now you will have to install the extension.
The `make` command below compiles the locales, schemas and resources, creates a zip file of the extension and finally installs it with the `gnome-extensions` tool.
```bash
make install
```
Then restart GNOME Shell with <kbd>Alt</kbd> + <kbd>F2</kbd>, <kbd>r</kbd> + <kbd>Enter</kbd>.
Or logout / login if you are on Wayland.
Then you can enable the extension with the *Gnome Tweak Tool*, the *Extensions* application or with this command:
```bash
gnome-extensions enable flypie@schneegans.github.com
```
<p align="center"><img src ="pics/hr.svg" /></p>
<p align="center">
<img src="pics/nav-space.svg"/>
<img src="pics/nav-space.svg"/>
<img src="pics/nav-space.svg"/>
<a href="../README.md#getting-started"><img src ="pics/home.png"/> Index</a>
<img src="pics/nav-space.svg"/>
<a href="first-steps.md">First Steps <img src ="pics/right-arrow.png"/></a>
</p>
|