Skip to content

README.md

Latest commit

 

History

History
99 lines (72 loc) · 4.29 KB

README.md

File metadata and controls

99 lines (72 loc) · 4.29 KB
Raw

Crowdin Donate

PSA: We are moving on gitlab, the repo on Github will remain as a mirror. Don't submit PR on gihub.

LeafPic

LeafPic is a fluid, material-designed alternative gallery, it also is ad-free and open source under GPLv3 license. It doesn't miss any of the main features of a stock gallery, and we also have plans to add more useful features.

Download



Table of Contents

Screenshots

Contributing

Prerequisites

  • Android Studio
  • Git
  • JDK (Java Development Kit)

Getting Started

  1. Fork and clone the repository:

    Fork the project on GitLab and clone your fork locally.

    git clone https://gitlab.com/YOUR_USERNAME/LeafPic.git

    cd LeafPic

  2. Open the project in Android Studio:

    Start Android Studio and select "Open an Existing Project", then navigate to the folder where you cloned LeafPic.

  3. Install the required SDKs:

    Android Studio will prompt you to install the Android SDK and other necessary tools if you have not already done so.

Building and Running

  1. Select a build variant: In Android Studio, you can select which version of the app you want to build (debug/release) from the Build Variants panel.

  2. Run the app: Connect an Android device to your computer or use the AVD (Android Virtual Device) Manager to create a new emulator. Click the 'Run' button in Android Studio to build and run the app on your device/emulator.

Testing

Do you want to be a tester? Join our Telegram group! Send a message to @dnldsht or @CalvinNoronha we will add you. We will release apks to test features or to check if bugs have been fixed.

Code

If you are a developer and you wish to contribute to the app please fork the project and submit a pull request on the dev branch. If you want, you can join us on Telegram - send us a message we will add you!

Issues

You can trace the status of known issues here, also feel free to file a new issue (helpful description, screenshots and logcat are appreciated), or send me an email if you have any questions.

Translations

If you are able to contribute with a new translation of a missing language or if you want to improve an existing one, we greatly appreciate any suggestion! The project uses Crowdin, a platform that allows anybody to contribute to translating the app

Licensing

LeafPic is licensed under the GNU v3 Public License. In addition to the terms set by the GNU v3 Public License, we ask that if you use any code from this repository that you send us a message to let us know.