mirror of
https://gitlab.gnome.org/World/Authenticator.git
synced 2025-03-08 18:51:00 +01:00
91 lines
2.4 KiB
Markdown
91 lines
2.4 KiB
Markdown
[](https://hosted.weblate.org/engage/authenticator/?utm_source=widget) [](https://github.com/bilelmoussaoui/Authenticator/releases)
|
|
|
|
# Authenticator
|
|
<img src="https://raw.githubusercontent.com/bilelmoussaoui/Authenticator/master/data/icons/hicolor/256x256/apps/com.github.bilelmoussaoui.Authenticator.png" width="128" height="128" />
|
|
<p>Two-factor authentication code generator for GNOME. Created with love using Python and GTK+.</p>
|
|
|
|
## Screenshots
|
|
|
|
<img src="data/screenshots/screenshot1.png" width="280" /> <img src="data/screenshots/screenshot2.png" width="280" /> <img src="data/screenshots/screenshot3.png" width="280" />
|
|
|
|
## Features
|
|
|
|
- QR code scanner
|
|
- Beautiful UI
|
|
- Huge database of (290+) websites/applications
|
|
|
|
## Installation
|
|
|
|
### Flatpak
|
|
You can install the `flatpak` package of the application from Flathub using
|
|
```
|
|
flatpak install flathub com.github.bilelmoussaoui.Authenticator
|
|
```
|
|
|
|
### Gentoo
|
|
Installing Authenticator in Gentoo Linux is as easy as follows:
|
|
```
|
|
emerge sys-auth/authenticator
|
|
```
|
|
|
|
### Building from source code
|
|
#### Dependecies
|
|
|
|
- `Python 3.3+`
|
|
- `Gtk 3.16+`
|
|
- `meson 0.38+`
|
|
- `ninja`
|
|
- `pyotp`
|
|
- `libsecret`
|
|
|
|
Those dependencies are only used if you build the application with QR code scanner support
|
|
- `Pillow`
|
|
- `pyzbar` depends on `zbar`
|
|
- `libzbar-dev` on Ubuntu
|
|
- `zbar` on Arch
|
|
|
|
1 - Clone the repository
|
|
|
|
```bash
|
|
git clone https://github.com/bilelmoussaoui/Authenticator && cd ./Authenticator
|
|
```
|
|
|
|
2 - Install Python dependecies
|
|
|
|
```bash
|
|
sudo pip install pyotp pyzbar Pillow meson ninja
|
|
```
|
|
|
|
<sub>PS: In some distributions you will need to use `pip3` instead of `pip` to install the compatible version of the package with Python 3.</sub> <br>
|
|
|
|
3 - Install system dependencies
|
|
|
|
The following packages must be installed to build Authenticator.
|
|
|
|
- Debian / Ubuntu
|
|
|
|
```bash
|
|
sudo apt install gobject-introspection libgirepository1.0-dev libgtk-3-dev
|
|
```
|
|
|
|
4 - Afterwards
|
|
|
|
```bash
|
|
meson builddir
|
|
sudo ninja -C builddir install
|
|
```
|
|
|
|
5 - You can run the application from the desktop file or from the terminal using
|
|
```bash
|
|
authenticator
|
|
```
|
|
|
|
## Flags
|
|
|
|
- `--version`
|
|
Shows the version number of the application
|
|
|
|
|
|
## Credits
|
|
|
|
- Database for applications/websites from [twofactorauth](https://github.com/2factorauth/twofactorauth), by the 2factorauth team
|