File: installation.md

package info (click to toggle)
gnome-shell-extension-flypie 32-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 20,332 kB
  • sloc: javascript: 10,888; xml: 684; sh: 208; makefile: 80
file content (87 lines) | stat: -rw-r--r-- 3,152 bytes parent folder | download | duplicates (2)
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>