Skip to content
This repository was archived by the owner on Mar 28, 2025. It is now read-only.

django-files/android-app

Repository files navigation

GitHub Release Version GitHub Last Commit GitHub Top Language GitHub Repo Size GitHub Discussions GitHub Forks GitHub Repo Stars GitHub Org Stars Discord

Django Files Android App

Caution

This project has been deprecated in favor of a Kotlin version.

Allows you to Share or Open any file with your Django Files server. The URL to the file is automatically copied to the clipboard and the preview is shown in the app.

Resource Resource Link
Website https://django-files.github.io/
GitHub https://github.com/django-files
Server https://github.com/django-files/django-files
iOS App https://github.com/django-files/ios-client

Install

Until the app is published it must be loaded with ADB or Android Studio.
This requires using Android Studio or the command line interface.

▶️ Click Here to View Quick CLI Steps
$ which adb
C:\Users\Shane\Android\sdk\platform-tools\adb.EXE

$ adb devices
List of devices attached
RF9M33Z1Q0M     device

$ wget https://github.com/django-files/android-app/releases/latest/download/app-debug.apk

$ ls
app-debug.apk

$ adb -s RF9M33Z1Q0M install app-debug.apk
Performing Streamed Install
Success

See below for more details...

  1. Download and Install Android Studio or the Android SDK Platform Tools.

https://developer.android.com/studio
https://developer.android.com/tools/releases/platform-tools#downloads

  1. Ensure that usb or wifi debugging is enabled in the Android developer settings and verify.

If using Android Studio your device should show up! Simply import the project, and press Play ▶️

Otherwise, continue with the steps below...

This assumes that adb is in your PATH. List and verify the device is connected with:

$ adb devices

List of devices attached
RF9M33Z1Q0M     device
  1. Download or build a debug apk (use gradle or Android Studio).

https://github.com/django-files/android-app/releases

./gradlew build
./gradlew assemble

Note: Use gradlew.bat for Windows.

  1. Unzip the release and change into the directory.

The built apk should be here: app/build/outputs/apk/debug

  1. Then install the apk to your device with adb.
$ adb -s RF9M33Z1Q0M install app-debug.apk

Performing Streamed Install
Success

For more details, see the ADB Documentation.

Setup

  1. Install and open the app.
  2. Enter the URL to your Django Files server.
  3. Log in as you normally would on the website.
  4. Done! You can now share any file to your Django Files server...

Features

  • Share or Open any file and automatically copy the URL to the clipboard.
  • Ability to manually change servers by entering a new URL from the Server List menu.
  • Supports Local Login, GitHub OAuth, Google OAuth, Discord OAuth (w/o passkeys).

Planned

  • Ability to save multiple servers and switch between them automatically in the Server List menu.
  • Ability for the app to log you in if your session is expired or when switching servers.

Known Issues

  • If you enter an incorrect url, you must clear the apps data or reinstall the app.
  • The app gets logged out if the session expires; however, sharing continues to work.
  • Login with Google OAuth gives an error; however, if you wait ~15 seconds it will succeed.
  • Login with Discord OAuth passkeys does not work.

Development

Android Studio: https://developer.android.com/studio

For now see Install.

Support

For general help or to request a feature, see:

If you are experiencing an issue/bug or getting unexpected results, you can:

Contributing

Currently, the best way to contribute to this project is to star this project on GitHub.

You can also support other related projects:

About

Django Files Android App

Topics

Resources

Stars

Watchers

Forks

Languages