{"id":20169779,"url":"https://github.com/piwigo/piwigo-flutter-app","last_synced_at":"2026-01-02T11:54:52.320Z","repository":{"id":37051363,"uuid":"360094411","full_name":"Piwigo/piwigo-flutter-app","owner":"Piwigo","description":"Piwigo mobile application for Android","archived":false,"fork":false,"pushed_at":"2024-10-23T23:56:41.000Z","size":34299,"stargazers_count":83,"open_issues_count":60,"forks_count":26,"subscribers_count":22,"default_branch":"master","last_synced_at":"2024-10-24T13:32:11.937Z","etag":null,"topics":["android","flutter"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Piwigo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-21T08:43:11.000Z","updated_at":"2024-10-16T18:16:02.000Z","dependencies_parsed_at":"2024-06-28T15:27:48.254Z","dependency_job_id":"8ff260e7-e9ae-4677-ab13-7fcc3ec4c446","html_url":"https://github.com/Piwigo/piwigo-flutter-app","commit_stats":null,"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Piwigo%2Fpiwigo-flutter-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Piwigo%2Fpiwigo-flutter-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Piwigo%2Fpiwigo-flutter-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Piwigo%2Fpiwigo-flutter-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Piwigo","download_url":"https://codeload.github.com/Piwigo/piwigo-flutter-app/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247406088,"owners_count":20933803,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","flutter"],"created_at":"2024-11-14T01:13:44.072Z","updated_at":"2026-01-02T11:54:52.281Z","avatar_url":"https://github.com/Piwigo.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Piwigo Next Generation (for Android)\n\nAn android application for managing and uploading images to Piwigo servers.\n\nThis app is **under development** by the Piwigo android team. The goal is to close the gap with the IOS Piwigo application while keeping in mind the priority of the features like the **upload**, and the ability to **select multiple images** at a time or to **take photos directly from the app** to upload them.\n\nAll features are not enabled and will be implemented when needed.\nIf you face trouble please [create tickets](https://github.com/Piwigo/piwigo-flutter-app/issues/new/choose) in case you detect a bug.\n\n\n# Installation\n\nYou can download the latest version either from Github or from Google Play Store:\n\n## Download from Play Store\n\nOn your Android phone:\n 1. Go to **Play Store**.\n 2. Search for **Piwigo NG** on search-bar.\n 3. Find the listing with the name **Piwigo NG (Early Access)** and click **Install**.\n\nAlternatively, you can directly go to the [Play Store page of Piwigo NG app](https://play.google.com/store/apps/details?id=com.piwigo.piwigo_ng).\n\n## Download from Github\n\n### Download the APK\n\nIn Github, Go to [piwigo-flutter-app releases](https://github.com/Piwigo/piwigo-flutter-app/releases), choose the version (latest is recommanded) and download the .apk file.\n\n### Install the APK\n\nOn your Android phone:\n 1. Go to **Settings** \u003e **security** \u003e **install unknown apps**.\n 2. Go to **files** and enable **Allow from this source**.\n *Don't forget to disable it when you have finished*\n 3. Exit **Settings** and go to **files**.\n 4. Go to **Downloads**, select the **.apk** and click **install**.\n 6. The app is now installed on your phone.\n\n# Usage\n\nHow to use Piwigo NG\n\n## Login\n![Piwigo's login screen](https://i.imgur.com/KIX3K2o.png)\n\n - Enter the piwigo **address** of the server you want to log into :\n\t - Switch between **http** and **https** by tapping on them.\n*[http is not supported yet](https://flutter.dev/docs/release/breaking-changes/network-policy-ios-android)*\n\t - No need to end the URL with a **/**.\n - Enter the **username** and the **password** for the server you want to log into :\n\t - Leave those fields **empty** if you just want to visit the server. You will be logged as a **guest**.\n - Tap the **Log in** button :\n\t - If the given URL is empty, the Log in button will be disabled.\n\t - If the login is not successful, a dialog describing the error will appear. Tap outside the dialog to retry.\n\n![Login Error Dialog](https://i.imgur.com/M1NgMtz.png)\n\n## Logout | Change server\n\n#### From the Albums Home Page\n- Go to **Settings**.\n\t- If you are logged in : Tap **Log out**.\n\t- If you are a guest : Tap **Log in**.\n\n![Settings Page](https://i.imgur.com/iPOjYRs.png)\n## Upload\nWith Piwigo NG, you can upload images from the phone.\n1. **Enter** (or **create**) an album.\n2. Tap on the **menu button** at the bottom right corner.\n3. Tap the **image button** to select images for upload.\n\n![Menu Button](https://i.imgur.com/TzxBA5c.png)\n\n4. **Select** the images from your phone\n\t4.1. You can **take a photo directly** from the app by tapping the camera icon.\n\n![Multiselection Page](https://i.imgur.com/Etvq7TE.png)\n\n5. Validate by tapping the **check** button on the top right corner.\n6. Review the selected images and tap the **upload** button to confirm or exit ton cancel.\n7. The upload will start in **background**, you can continue to use the app or even leave it.\n\t7.1. Some **notifications** will appear each time an image is fully downloaded.\n\t7.2. The result will be visible when all the images have been updated.\n\n![Upload Page](https://i.imgur.com/Etvq7TE.png)\n\n# Flutter\n\nThis application is made with [Flutter](https://flutter.dev/?gclid=Cj0KCQjwvYSEBhDjARIsAJMn0lj-G1Ly0oznQeMGvyTYBY2TZfxFpkb9WYp4dsyMSwKIUsmTwE-SltIaAsjFEALw_wcB\u0026gclsrc=aw.ds)\n\nA UI toolkit for building beautiful, natively compiled applications for [mobile](https://flutter.dev/docs), [web](https://flutter.dev/web), and [desktop](https://flutter.dev/desktop) from a single codebase.\n\nWe are using it for Android only.\n\n# Piwigo API\n\nThe connection to the server is made with the Piwigo's API.\n\n## Upload\n\nFor the upload, we are using the **uploadAsync** method of the API. This method requires to **chunk** the image with a size given by the server. All chunks are uploaded simultaneously and reorganized by the server.\n\n\n# Licence\n\nPiwigo is a free software, it can be redistributed it and / or modified under the terms of the GNU General Public License\n[see more here](./LICENCE.txt)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiwigo%2Fpiwigo-flutter-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiwigo%2Fpiwigo-flutter-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiwigo%2Fpiwigo-flutter-app/lists"}