Aves logo ## Aves [ˈaː.ves] ![Version badge][Version badge] ![RB badge][RB badge] ![Build badge][Build badge] Aves is a gallery and metadata explorer app. It is built for Android, with Flutter. [Get it on Google Play](https://play.google.com/store/apps/details?id=deckers.thibault.aves&pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1) [Get it on IzzyOnDroid](https://apt.izzysoft.de/fdroid/index/apk/deckers.thibault.aves) [Get it on Obtainium](https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/deckerst/aves) [Get it on F-Droid](https://f-droid.org/packages/deckers.thibault.aves.libre) [Get it on GitHub](https://github.com/deckerst/aves/releases/latest) [Compare versions](https://github.com/deckerst/aves/wiki/App-Versions)
## Features Aves can handle all sorts of images and videos, including your typical JPEGs and MP4s, but also more exotic things like **multi-page TIFFs, SVGs, old AVIs and more**! It scans your media collection to identify **motion photos**, **panoramas** (aka photo spheres), **360° videos**, as well as **GeoTIFF** files. **Navigation and search** is an important part of Aves. The goal is for users to easily flow from albums to photos to tags to maps, etc. Aves integrates with Android (including Android TV) with features such as **widgets**, **app shortcuts**, **screen saver** and **global search** handling. It also works as a **media viewer and picker**. ## Screenshots
[Collection screenshot](https://raw.githubusercontent.com/deckerst/aves_extra/main/screenshots/play/en/1.png) [Image screenshot](https://raw.githubusercontent.com/deckerst/aves_extra/main/screenshots/play/en/2.png) [Stats screenshot](https://raw.githubusercontent.com/deckerst/aves_extra/main/screenshots/play/en/5.png) [Info (basic) screenshot](https://raw.githubusercontent.com/deckerst/aves_extra/main/screenshots/play/en/3.png) [Info (metadata) screenshot](https://raw.githubusercontent.com/deckerst/aves_extra/main/screenshots/play/en/4.png) [Countries screenshot](https://raw.githubusercontent.com/deckerst/aves_extra/main/screenshots/play/en/6.png)
## Changelog The list of changes for past and future releases is available [here](https://github.com/deckerst/aves/blob/develop/CHANGELOG.md). ## Permissions | Permission | Purpose | | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- | | READ_MEDIA_IMAGES
READ_MEDIA_VIDEO
READ_MEDIA_VISUAL_USER_SELECTED
ACCESS_MEDIA_LOCATION | Media collection read access | | MANAGE_MEDIA | Media collection write access | | FOREGROUND_SERVICE
FOREGROUND_SERVICE_MEDIA_PROCESSING
POST_NOTIFICATIONS
ACCESS_NETWORK_STATE
ACCESS_WIFI_STATE
RECEIVE_BOOT_COMPLETED | Media scan service feedback | | INTERNET | Map view, reverse geocoding | | SET_WALLPAPER | Wallpaper setting | | USE_BIOMETRIC
USE_FINGERPRINT | Vault lock | | WAKE_LOCK | Keeping screen on | ## Contributing ### Issues [Bug reports](https://github.com/deckerst/aves/issues/new?assignees=&labels=type%3Abug&template=bug_report.yml&title=) and [feature requests](https://github.com/deckerst/aves/issues/new?assignees=&labels=type%3Afeature&template=feature_request.yml&title=) are welcome, but read the [guidelines](https://github.com/deckerst/aves/issues/234) first. If you have questions, check out the [discussions](https://github.com/deckerst/aves/discussions). ### Code At this stage this project does *not* accept PRs. ### Translations Translations are powered by [Weblate](https://hosted.weblate.org/engage/aves/) and the effort of wonderfully generous volunteers. Translation status If you want to translate this app in your language and share the result, [there is a guide](https://github.com/deckerst/aves/wiki/Contributing-to-Translations). ### Donations Some users have expressed the wish to financially support the project. Thanks! ❤️ [Donate with PayPal](https://www.paypal.com/donate/?hosted_button_id=RWKQ4J7D8USX6) [Donate using Liberapay](https://liberapay.com/deckerst/donate) ## Project Setup Before running or building the app, update the dependencies for the desired flavor: ``` # scripts/apply_flavor_play.sh ``` To build the project, create a file named `/android/key.properties`. It should contain a reference to a keystore for app signing, and other necessary credentials. See [key_template.properties](https://github.com/deckerst/aves/blob/develop/android/key_template.properties) for the expected keys. To run the app: ``` # ./flutterw run -t lib/main_play.dart --flavor play ``` To debug the app Kotlin code, if attaching the debugger from Android Studio fails: 1) open `android` folder in Android Studio, 2) `Edit Configurations...`, 3) select configuration `app`, 4) select tab `Debugger` 5) select tab `LLDB Post Attach Commands` 6) add: ``` process handle SIGSEGV --pass true --stop false --notify true ``` ## Certificate Fingerprint ``` Owner: CN=Thibault Deckers Issuer: CN=Thibault Deckers Serial number: 12957861 Valid from: Wed Dec 07 08:07:30 CET 2016 until: Sun Dec 01 08:07:30 CET 2041 Certificate fingerprints: SHA1: 59:A5:00:13:FA:7A:2F:97:91:1B:52:D6:81:CA:FA:EB:F8:35:05:E8 SHA256: F4:79:47:27:E4:54:16:D8:7C:48:71:38:29:2B:70:9F:11:D1:CD:7D:AB:55:84:D8:C6:85:7D:92:E0:66:60:4B ``` SHA1: ```text 59:A5:00:13:FA:7A:2F:97:91:1B:52:D6:81:CA:FA:EB:F8:35:05:E8 ``` SHA256: ```text F4:79:47:27:E4:54:16:D8:7C:48:71:38:29:2B:70:9F:11:D1:CD:7D:AB:55:84:D8:C6:85:7D:92:E0:66:60:4B ``` [Version badge]: https://img.shields.io/github/v/release/deckerst/aves?include_prereleases&sort=semver [RB badge]: https://shields.rbtlog.dev/simple/deckers.thibault.aves [Build badge]: https://img.shields.io/github/actions/workflow/status/deckerst/aves/quality-check.yml?branch=develop