Wrapper of syncthing for Android.
Go to file
Gonzalo Raul Nemmi 176e869695
Translated using Weblate (Spanish (Latin America))
Currently translated at 100.0% (3 of 3 strings)

Translation: Syncthing/Google Play listings
Translate-URL: https://hosted.weblate.org/projects/syncthing/android/play-listings/es_419/
2024-06-17 09:09:27 +02:00
.github Add PR template (#2050) 2024-02-10 20:45:29 +01:00
.tx Fix Transifex config to make pull script work again. (#1993) 2023-11-07 22:20:26 +01:00
app Translated using Weblate (Spanish (Latin America)) 2024-06-17 09:09:27 +02:00
docker Bump go to 1.22.1 2024-03-10 15:13:08 +01:00
gradle/wrapper Upgrade Gradle wrapper to version `8.5` (#2021) 2024-01-10 21:27:21 +01:00
graphics Integrate gradle plugin for translation uploads (fixes #408, #463). 2015-11-16 22:10:00 +01:00
scripts Refactor groovy gradle files to kotlin dsl (#2022) 2023-12-28 22:37:27 +01:00
syncthing Updated Syncthing to v1.27.6 2024-04-10 08:26:47 +02:00
.gitignore Ignore misc IDE files 2021-07-19 13:38:36 +02:00
.gitmodules Revert "Revert build script changes" 2017-10-24 14:55:28 +09:00
CONTRIBUTING.md Fixing typo Github to GitHub (fixes #2041) (#2070) 2024-03-22 23:52:36 +01:00
ISSUE_TEMPLATE.md Fix issue template 2024-01-28 12:14:08 +01:00
LICENSE Change license to MPLv2. 2015-03-17 22:27:50 +01:00
README.md Remove bountysource from readme (fixes #2024) 2023-12-08 12:50:27 +01:00
build.gradle.kts Update dependency resolution management (#2000) 2024-01-03 09:35:19 +01:00
gradle.properties build: Increase java heap size with gradle jvmargs 2021-07-18 14:32:52 +02:00
gradlew Update gradle (#1405) 2019-09-10 20:06:45 +02:00
gradlew.bat Update gradle (#1405) 2019-09-10 20:06:45 +02:00
prepare-release.bash Commit the rest of the build changes 2019-06-27 07:19:40 +02:00
settings.gradle.kts Update dependency resolution management (#2000) 2024-01-03 09:35:19 +01:00

README.md

syncthing-android

License: MPLv2

A wrapper of Syncthing for Android.

screenshot 1 screenshot 2 screenshot 3

Get it on Google Play Get it on F-Droid

Status: "Maintenance mode" - Co-maintainers welcome

tl;dr: The app is still kept up to date, and contributions are still welcome - however even reviews for those can take a long time. Co-maintainers are very welcome - get in touch if you are interested.

No-one is dedicating significant time into development or reviews. It's still kept up to date with Syncthing, Android and dependencies under the wider Syncthing project umbrella on a best effort basis. Contributions are reviewed, however available time for that is scarce so it will take a while. And obviously it depends both on the size/clarity of the change and (admittedly subjective) relevance of it - chance of successful and speedier reviews is higher if your change is targeted and small.

No feature request taken (feature contributions case-by-case)

Handling feature requests use up the little time that is present to keep the app up-to-date, and there is no feature development happening. So unless you are opening a feature request to discuss your own contribution before jumping into coding, the request will be closed directly with some template answer pointing at this section.

Translations

The project is translated on Hosted Weblate.

Dev

Language codes are usually mapped correctly by Weblate itself. The supported set is different between Google Play and Android apps. The latter can be deduced by what the Android core framework itself supports. New languages need to be added in the repository first, then appear automatically in Weblate.

Building

These dependencies and instructions are necessary for building from the command line. If you build using Docker or Android Studio, you don't need to set up and follow them separately.

Dependencies

  1. Android SDK and NDK
    1. Download SDK command line tools from https://developer.android.com/studio#command-line-tools-only.

    2. Unpack the downloaded archive to an empty folder. This path is going to become your ANDROID_HOME folder.

    3. Inside the unpacked cmdline-tools folder, create yet another folder called latest, then move everything else inside it, so that the final folder hierarchy looks as follows.

      cmdline-tools/latest/bin
      cmdline-tools/latest/lib
      cmdline-tools/latest/source.properties
      cmdline-tools/latest/NOTICE.txt
      
    4. Navigate inside cmdline-tools/latest/bin, then execute

      ./sdkmanager "platform-tools" "build-tools;<version>" "platforms;android-<version>" "extras;android;m2repository" "ndk;<version>"
      

      The required tools and NDK will be downloaded automatically.

      NOTE: You should check Dockerfile for the specific version numbers to insert in the command above.

  2. Go (see https://docs.syncthing.net/dev/building#prerequisites for the required version)
  3. Java version 11 (if not present in $PATH, you might need to set $JAVA_HOME accordingly)
  4. Python version 3

Build instructions

  1. Clone the project with
    git clone https://github.com/syncthing/syncthing-android.git --recursive
    
    Alternatively, if already present on the disk, run
    git submodule init && git submodule update
    
    in the project folder.
  2. Make sure that the ANDROID_HOME environment variable is set to the path containing the Android SDK (see Dependecies).
  3. Navigate inside syncthing-android, then build the APK file with
    ./gradlew buildNative
    ./gradlew assembleDebug
    
  4. Once completed, app-debug.apk will be present inside app/build/outputs/apk/debug.

NOTE: On Windows, you must use the Command Prompt (and not PowerShell) to compile. When doing so, in the commands replace all forward slashes / with backslashes \.

License

The project is licensed under the MPLv2.