README.md 2.17 KB
Newer Older
Gabriele Musco's avatar
Gabriele Musco committed
1
2
3
4
# <a href="https://gabmus.gitlab.io/whatip"><img height="32" src="data/icons/org.gabmus.whatip.svg" /> What IP</a>

Info on your IP

Gustavo Costa's avatar
Gustavo Costa committed
5
![screenshot](https://gitlab.gnome.org/GabMus/whatip/-/raw/website/static/screenshots/mainwindow.png)
Gabriele Musco's avatar
Gabriele Musco committed
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

## Notes on the distribution of this app

I decided to target flatpak mainly. It's just another package manager at the end of the day, but
it's supported by many Linux distributions. It bundles all of the dependencies you need in one
package.

This helps a lot in supporting many different distros because I know which version of which
dependency you have installed, so I don't have to mess with issues caused by version mismatches.
If you want to report an issue, feel free to. But please at least first see if this issue happens
with the flatpak version as well.

As for development it's a similar story. I do most of my testing directly inside a flatpak sandbox
and you should do the same. It's easy to set up, just open up this repo in GNOME Builder and press
the run button. It will handle the rest.

## Installing from Flathub

You can install What IP via [Flatpak](https://flathub.org/apps/details/org.gabmus.whatip).

## Installing from AUR

What IP is available as an AUR package: [`whatip-git`](https://aur.archlinux.org/packages/whatip-git/).

<!--
## Installing from Fedora

What IP is available in [Fedora repos](https://apps.fedoraproject.org/packages/whatip): `sudo dnf install whatip`
-->

# Building on different distributions

**Note**: these are illustrative instructions. If you're a developer or a package maintainer, they
can be useful to you. If not, just install the flatpak.

## Building on Ubuntu/Debian

```bash
sudo apt-get install python-requests

46
git clone https://gitlab.gnome.org/GabMus/whatip
Gabriele Musco's avatar
Gabriele Musco committed
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
cd whatip
mkdir build
cd build
meson ..
meson configure -Dprefix=$PWD/testdir # use this line if you want to avoid installing system wide
ninja
ninja install
```

## Building on Arch/Manjaro

```bash
sudo pacman -S python-requests python-gobject

git clone https://gitlab.gnome.org/GabMus/whatip
cd whatip
mkdir build
cd build
meson ..
meson configure -Dprefix=$PWD/testdir # use this line if you want to avoid installing system wide
ninja
ninja install
```