deckerst/aves

Changelog

The list of changes for past and future releases is available here.

Permissions

Aves requires a few permissions to do its job:

• read contents of shared storage: the app only accesses media files, and modifying them requires explicit access grants from the user,
• read locations from media collection: necessary to display the media coordinates, and to group them by country (via reverse geocoding),
• have network access: necessary for the map view, and most likely for precise reverse geocoding too,
• view network connections: checking for connection states allows Aves to gracefully degrade features that depend on internet.

Contributing

Issues

Bug reports and feature requests are welcome, but read the guidelines first. If you have questions, check out the discussions.

Code

At this stage this project does not accept PRs.

Translations

Translations are powered by Weblate and the effort of wonderfully generous volunteers.

If you want to translate this app in your language and share the result, there is a guide.

Donations

Some users have expressed the wish to financially support the project. Thanks! ❤️

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 <app dir>/android/key.properties. It should contain a reference to a keystore for app signing, and other necessary credentials. See 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