Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/casimir/frigoligo

Your articles with you
https://github.com/casimir/frigoligo

desktop-app mobile-app wallabag

Last synced: 5 days ago
JSON representation

Your articles with you

Host: GitHub
URL: https://github.com/casimir/frigoligo
Owner: casimir
License: mit
Created: 2023-07-18T19:11:01.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-11-06T23:16:35.000Z (7 days ago)
Last Synced: 2024-11-07T00:25:07.905Z (7 days ago)
Topics: desktop-app, mobile-app, wallabag
Language: Dart
Homepage:
Size: 49.8 MB
Stars: 53
Watchers: 2
Forks: 4
Open Issues: 14
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

        # 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/)

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

Frigoligo is aiming at being:

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 keep synchronization efficient.

5. **Innovative**: Experiment with new ideas on top of the solid backend that is wallabag.

## Installation

[](https://apps.apple.com/us/app/frigoligo/id6451362294) [](https://play.google.com/store/apps/details?id=net.casimirlab.frigoligo) [](https://f-droid.org/fr/packages/net.casimirlab.frigoligo/) [](https://apt.izzysoft.de/fdroid/index/apk/net.casimirlab.frigoligo)

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/). Not that this is still experimental and that it is automatically updated with the latest commits on the `main` branch.

## Features

Missing but planned feature 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 allows it to be integrated in 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 follow 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

#### `/articles/: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 prefills the given credentials. Be aware that such 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 translating Frigoligo in your language by using [Weblate](https://hosted.weblate.org/engage/frigoligo/). Please come and help!

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