# Frigoligo

[![Chat on Matrix](https://img.shields.io/matrix/frigoligo%3Aone.ems.host?server_fqdn=matrix.org)](https://matrix.to/#/#frigoligo:one.ems.host)
[![Translation status](https://hosted.weblate.org/widget/frigoligo/flutter/svg-badge.svg)](https://hosted.weblate.org/engage/frigoligo/)
[![Test coverage](https://sonarcloud.io/api/project_badges/measure?project=casimir_frigoligo&metric=coverage)](https://sonarcloud.io/summary/new_code?id=casimir_frigoligo)

Frigoligo is a [wallabag](https://wallabag.org/) client crafted using [Flutter](https://flutter.dev/). Its core philosophy is to prioritize pragmatism and adhere to best practices when it makes sense.

Frigoligo aims to be:

1. **KISS**: Keep It Simple, Stupid. It should feel light and functional.
2. **Universal**: Provides a consistent experience on Android, iOS, macOS, Linux and Windows.
3. **Pluggable**: Can be integrated into any workflows easily, using deep links and OS integrations.
4. **Offline first**: Works offline as much as possible and keeps synchronization efficient.
5. **Innovative**: Experiment with new ideas on top of the solid backend that is wallabag.

## Installation

<p>
  <a href="https://apps.apple.com/us/app/frigoligo/id6451362294"><img src="./assets/logos/badge_apple_app_store.svg" alt="Download on the App Store" width="180" height="60" /></a>
  <a href="https://play.google.com/store/apps/details?id=net.casimirlab.frigoligo"><img src="./assets/logos/badge_google_play_store.svg" alt="Get it on Google Play" width="180" height="60" /></a>
  <a href="https://f-droid.org/fr/packages/net.casimirlab.frigoligo/"><img src="./assets/logos/badge_fdroid.svg" alt="Download on F-Droid" width="180" height="60" /></a>
  <a href="https://apt.izzysoft.de/fdroid/index/apk/net.casimirlab.frigoligo"><img src="./assets/logos/badge_izzyondroid.svg" alt="Download on F-Droid (Izzy)" width="180" height="60" /></a>
</p>
<p>
  <a href="https://flathub.org/apps/details/net.casimirlab.frigoligo"><img src="./assets/logos/badge_flathub.svg" alt="Download on Flathub" width="180" height="60" /></a>
</p>

You can also download the installer from the [latest release](https://github.com/casimir/frigoligo/releases/latest) for the following platforms: Android (apk), Linux, AppImage and Windows.

It is also possible to use Frigoligo as a web app, available [here](https://casimir.github.io/frigoligo/). Note that this is still experimental and that it is automatically updated with the latest commits on the `main` branch.

## Features

Missing but planned features are tracked in the [issues](https://github.com/casimir/frigoligo/issues?q=is%3Aissue+is%3Aopen+label%3A"missing+feature").

A full history of changes is available in [CHANGELOG.md](./CHANGELOG.md).

## Screenshots

|                                                   Mobile                                                    |                         Desktop                         |                                                         Mobile (dark)                                                          |
|:-----------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------:|:------------------------------------------------------------------------------------------------------------------------------:|
| ![mobile screenshot](./fastlane/metadata/android/en-US/images/phoneScreenshots/android_phone__1-listing.png) | ![desktop screenshot](./assets/screenshots/desktop.png) | ![mobile dark screenshot](./fastlane/metadata/android/en-US/images/phoneScreenshots/android_phone__4-reading-settings-dark.png) |

## Deeplinks

Frigoligo supports a few deeplinks that allow it to be integrated into external workflows. All platforms except Linux are supported.

### Links format

Deeplinks are based on a custom scheme, the URI path is used to determine the action to perform.

The following link will open the app and perform the `action` action with the given parameters `param1` (`hello`) and `param2` (`Günther`). Note that the host `x` is just here for readability and is ignored.

```
frigoligo://x/action?param1=hello&param2=G%C3%BCnther
```

### Actions

#### `/?articleId=:articleId`

Open the article with the given ID respecting the correct app navigation mode.

| Parameter   | Description                             | Required |
|-------------|-----------------------------------------|----------|
| `articleId` | The wallabag ID of the article to open. | Yes      |

#### `/login`

Open the login page and prefill the given credentials. Be aware that such a link in the wild weakens the security of your account.

| Parameter      | Description                  | Required |
|----------------|------------------------------|----------|
| `server`       | Your wallabag server URL.    | No       |
| `clientId`     | Your wallabag client ID.     | No       |
| `clientSecret` | Your wallabag client secret. | No       |
| `username`     | Your wallabag username.      | No       |
| `password`     | Your wallabag password.      | No       |

#### `/logs`

Open the log console. Useful to debug issues when the application is soft lock.

#### `/save`

Save a new article. This is super useful to integrate article saving from an external workflow.

| Parameter | Description                     | Required |
|-----------|---------------------------------|----------|
| `url`     | The URL of the article to save. | Yes      |

## License

Licensed under the MIT. See [LICENSE](./LICENSE) for details.

## Translations

You can help translate Frigoligo into your language by using [Weblate](https://hosted.weblate.org/engage/frigoligo/). Please come and help!

Note that, to be used in the application, the translation must be at least 80% complete.

[![Translation status](https://hosted.weblate.org/widget/frigoligo/flutter/multi-auto.svg)](https://hosted.weblate.org/engage/frigoligo/)