iakdis/librecamera

https://img.shields.io/github/v/release/iakdis/librecamera?style=flat-square https://img.shields.io/f-droid/v/com.iakmds.librecamera?style=flat-square https://img.shields.io/github/issues/iakdis/librecamera?style=flat-square https://img.shields.io/github/issues-pr/iakdis/librecamera?style=flat-square https://img.shields.io/github/contributors/iakdis/librecamera?style=flat-square https://img.shields.io/github/forks/iakdis/librecamera?style=flat-square https://img.shields.io/github/stars/iakdis/librecamera?style=flat-square https://img.shields.io/github/license/iakdis/librecamera?style=flat-square Translation status

Libre Camera app icon

Libre Camera

A free and open source camera app for Android written in Flutter and Dart licensed under the GPLv3

Get it on F-Droid

Table of Contents

1. About Libre Camera
   • Screenshots
   • Download
   • Features
2. Roadmap
3. Contributing
   • Translate
   • Bug reporting or feature requests
   • Code
4. Packages used
5. License

Screenshots

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4

Download

You can download Libre Camera on F-Droid by tapping on the badge below. Alternatively, download and install the apk directly from the GitHub releases page. Downloading directly from the GitHub releases page will likely download a more recent version (if a new version was published recently) – notice though that the F-Droid and the GitHub versions aren't compatible with one another. You will need to reinstall the app; make sure you remember your settings.

Get it on F-Droid Get it on GitHub

Features

• Take pictures and record videos with your rear and front camera
• Privacy: No EXIF metadata saved by default when taking pictures (enable optionally in settings) – without ads, tracking, or unnecessary permissions
• Themes: Material Design with a Dark, Light, Black or system theme
• Multiple languages supported – Contribute translating your language!
• Zoom: Zoom with 2 fingers or with an optional slider
• Timer/Delay: Select a photo capture timer to get ready for your photo
• Flashlight modes: On at capture, Off, Auto, Always on
• Focus: Auto focus, locked focus and manual focus by touching the screen
• Exposure: Auto exposure, locked exposure and manual exposure with an optional slider
• Image compression: Set the compression amount in the settings
• Formats: Switch between 4 compression formats (JPEG, PNG, WebP, HEIC)
• Resolutions: Switch between different camera resolutions
• FPS: Switch between different video frame rates
• Save location: Choose your preferred save location
• Small size (<20 MB)
• Customizable: Open the settings to customize the app to your liking!

Roadmap

• [ ] More supported languages (See #translate below)
• [ ] Your features
• [ ] Flutter issue: Allow custom resolution and aspect ratio (Fix #21)
• [ ] Flutter issue: Set custom frame rate and bit rate (Fix #21)
• [ ] Flutter issue: Switch between multiple cameras (Fix #18)
• [ ] Flutter issue: Manual focus distance (Fix #3)
• [ ] Feature: Add integrated QR-Scanner (Fix #32)
• [ ] Settings: Add a search bar for the settings page
• [x] (Included in version 1.9.0) Theme: Add a black Dark mode for AMOLED screens
• [x] (Included in version 1.8.0) Feature: Add "photo capture at phone volume button press" as an option in settings
• [x] (Included in version 1.7.0) Flutter issue: Flip camera while recording
• [x] (Included in version 1.3.0) Feature: Add photo capture delay option
• [x] (Included in version 1.3.0) Feature: Add a capture sound as an option in settings
• [x] Weblate integration
• [x] Check tablet support

Contributing

These are the ways you can contribute to Libre Camera:

Translation status

Translate

Translation status

Translating guide: Translations are now handled using Weblate! To use Weblate, log into your Weblate account and choose one of the 2 components you want to translate: Either the app itself or the F-Droid metadata. Now, select the language you want to translate or add a new language. You will see a list of different strings to choose from; untranslated and unfinished strings will probably be of most interest to you. And finally: Have fun translating!

Before using Weblate you had to translate Libre Camera manually via pull requests. Thank you @Loughty, @zehrique, @vladkorotnev, @metezd, @ZiTAL and @melentan!

Bug Reporting or Feature Requests

Open an issue on GitHub: Open issue

Remember to check for duplicates and try to give important information such as the app version, Android version, etc.

Code

Feel free to send in a pull request! To get started with Flutter, follow this link: https://docs.flutter.dev/get-started/install

1. Clone this repository
2. Switch to the project's directory and run flutter pub get to get all necessary packages. To test the app, run the project in debug mode by selecting an Android device or emulator in your preferred Flutter IDE and running the app in debug mode
3. To build the final app, run the following command in your terminal: flutter build apk – the output apk will be generated at librecamera/build/app/outputs/apk/release/. To receive all localized strings, run flutter gen-l10n. If you'd like to get multiple apks by splitting them into different platforms (results in smaller sizes), use flutter build apk --split-per-abi.

Packages used

The packages used for this app, also listed in the pubspec.yaml file. See their respective licenses.

Package	Use case
camera	Camera functionality
device_info_plus	Getting the Android version to adapt saving behaviour
dynamic_color	Getting the Android Material 3 dynamic color
file_picker	Picking the save path
flutter	Flutter SDK
flutter_image_compress	Image compression and EXIF metadata removal
flutter_localizations	Localization
image	Ability to flip captured photos horizontally
intl	Localization
native_device_orientation	Automatic orientation based on the phones sensor
package_info_plus	Display the programs version number
permission_handler	Handling permissions
provider	State management (localization and themes)
screen_brightness	Maximum screen brightness option
shared_preferences	Saving app data like settings
smooth_page_indicator	Page indicator in the onboarding screen
url_launcher	Open the GitHub repository link inside the about menu
video_player	Displaying a captured video inside the thumbnail
wakelock_plus	Keeping the display always on

License

This project is licensed under the GNU General Public License Version 3. For details, see LICENSE