1
1
[ ![ GitHub Downloads] ( https://img.shields.io/github/downloads/django-files/android-client/total?logo=github )] ( https://github.com/django-files/android-client/releases/latest/download/django-files.apk )
2
2
[ ![ GitHub Release Version] ( https://img.shields.io/github/v/release/django-files/android-client?logo=github )] ( https://github.com/django-files/android-client/releases/latest )
3
- [ ![ GitHub Last Commit] ( https://img.shields.io/github/last-commit/django-files/android-client?logo=github&label=updated )] ( https://github.com/django-files/android-client/graphs/commit-activity )
4
3
[ ![ GitHub Top Language] ( https://img.shields.io/github/languages/top/django-files/android-client?logo=htmx )] ( https://github.com/django-files/android-client )
4
+ [ ![ GitHub Last Commit] ( https://img.shields.io/github/last-commit/django-files/android-client?logo=github&label=updated )] ( https://github.com/django-files/android-client/graphs/commit-activity )
5
5
[ ![ GitHub Repo Size] ( https://img.shields.io/github/repo-size/django-files/android-client?logo=bookstack&logoColor=white&label=repo%20size )] ( https://github.com/django-files/android-client )
6
6
[ ![ GitHub Discussions] ( https://img.shields.io/github/discussions/django-files/android-client )] ( https://github.com/django-files/android-client/discussions )
7
7
[ ![ GitHub Forks] ( https://img.shields.io/github/forks/django-files/android-client?style=flat&logo=github )] ( https://github.com/django-files/android-client/forks )
16
16
- [ Features] ( #Features )
17
17
- [ Planned] ( #Planned )
18
18
- [ Known Issues] ( #Known-Issues )
19
- - [ Building ] ( #Building )
19
+ - [ Development ] ( #Development )
20
20
- [ Android Studio] ( #Android-Studio )
21
21
- [ Command Line] ( #Command-Line )
22
- - [ Development] ( #Development )
23
22
- [ Support] ( #Support )
24
23
- [ Contributing] ( #Contributing )
25
24
26
25
Allows you to Share or Open any file with your Django Files server.
27
26
The URL to the file is automatically copied to the clipboard and the preview is shown in the app.
28
27
29
- | Resource | Resource  ; Link |
30
- | -------- | :------------------------------------------- |
31
- | Website | https://django-files.github.io/ |
32
- | GitHub | https://github.com/django-files |
33
- | Server | https://github.com/django-files/django-files |
34
- | iOS App | https://github.com/django-files/ios-client |
28
+ | Django  ; Files | Link |
29
+ | ----------------- | :-------------------------------------------- |
30
+ | Website | https://django-files.github.io/ |
31
+ | GitHub | https://github.com/django-files |
32
+ | Server | https://github.com/django-files/django-files |
33
+ | iOS App | https://github.com/django-files/ios-client |
34
+ | Web Extension | https://github.com/django-files/web-extension |
35
+
36
+ > Django Files Android App is now signed starting at version 0.0.3
35
37
36
38
# Install
37
39
38
- > Django Files is now signed starting at version 0.0.3
40
+ > [ !TIP]
41
+ > To Install, download the latest release from GitHub and open it.
42
+ >
43
+ > - [ Click Here to Download the Latest Release] ( https://github.com/django-files/android-client/releases/latest/download/django-files.apk )
39
44
40
- - [ Download Latest Release ] ( https://github.com/django-files/android-client/releases/latest/download/django-files.apk )
45
+ _ Note: Until published on the play store, you may need to allow installation of apps from unknown sources. _
41
46
42
- _ Until the app is published on the play store, you must allow installation of apps from unknown sources._
47
+ ** First try to download and install the [ Latest Release] ( https://github.com/django-files/android-client/releases/latest/download/django-files.apk ) .**
48
+ This should take you to the settings to allow installing the app. If not, try the steps below.
43
49
44
50
1 . Go to your device settings.
45
51
2 . Search for "Install unknown apps" or similar.
46
52
3 . Choose the app you will install the apk file from.
47
53
- Select your web browser to install directly from it.
48
- - Select your file manager to open it, locate the APK and install from there.
49
- 4 . [ Download the Latest Release] ( https://github.com/django-files/android-client/releases/latest/download/django-files.apk ) .
50
- 5 . Open the download in the app you selected in step #3 .
51
- 6 . Choose Install and Accept Play Protect notifications.
52
- 7 . The app is now installed, proceed to [ Setup] ( #Setup ) .
54
+ - Select your file manager to open it, locate the apk and install from there.
55
+ 4 . Download the [ Latest Release] ( https://github.com/django-files/android-client/releases/latest/download/django-files.apk ) .
56
+ 5 . Open the download apk in the app you selected in step #3 .
57
+ 6 . Choose Install and Accept any Play Protect notifications.
58
+ 7 . The app is now installed. Proceed to the [ Setup] ( #Setup ) section below .
53
59
54
60
## Setup
55
61
56
- 1 . [ Install] ( #Install ) and open the app.
62
+ 1 . [ Install] ( #Install ) and open the app on your device .
57
63
2 . Enter the URL to your Django Files server.
58
64
3 . Log in as you normally would on the website.
59
- 4 . Done! You can now share any file to your Django Files server...
65
+ 4 . All Done! You can now share and open files with Django Files.
66
+
67
+ To use, share or open any file and choose the Django Files app.
68
+ The app will then be upload the file to your Django Files server.
69
+ Additionally, the URL is copied to the clipboard and the preview is show in the app.
60
70
61
71
# Features
62
72
63
- - Share or Open any file and automatically copy the URL to the clipboard.
73
+ - Share or Open any file (or multiple) and automatically copy the URL to the clipboard.
64
74
- Ability to manually change servers by entering a new URL from the Server List menu.
65
75
- Supports Local Login, GitHub OAuth, Google OAuth, Discord OAuth (w/o passkeys).
66
76
@@ -75,9 +85,9 @@ _Until the app is published on the play store, you must allow installation of ap
75
85
- Login with Google OAuth gives an error; however, if you wait ~ 30 seconds it will succeed.
76
86
- The app gets logged out if the session expires; however, sharing continues to work.
77
87
78
- # Building
88
+ # Development
79
89
80
- Covers Android Studio and Command Line.
90
+ This section briefly covers [ Android Studio] ( #Android-Studio ) and [ Command Line] ( #Command-Line ) setup .
81
91
82
92
## Android Studio
83
93
@@ -91,18 +101,18 @@ https://developer.android.com/studio
91
101
- Import the Project
92
102
- Run Gradle Sync
93
103
94
- To Run. Select your device and press Play ▶️
104
+ To Run: Select your device and press Play ▶️
95
105
96
- To Build.
106
+ To Build:
97
107
98
108
- Select the Build Variant (debug or release)
99
109
- Build > Generate App Bundles or APK > Generate APKs
100
110
101
111
## Command Line
102
112
103
- You will need to have [ ADB ] ( https://developer.android.com/tools/adb ) installed.
113
+ _ Note: This section is a WIP! _
104
114
105
- _ Note: This section is a WIP and contains building instructions for the command line. _
115
+ You will need to have [ ADB ] ( https://developer.android.com/tools/adb ) installed.
106
116
107
117
<details ><summary >Click Here to Download and Install a Release</summary >
108
118
@@ -169,12 +179,6 @@ _Note: you may have to uninstall before installing due to different certificate
169
179
170
180
For more details, see the [ ADB Documentation] ( https://developer.android.com/tools/adb#move ) .
171
181
172
- # Development
173
-
174
- Android Studio: https://developer.android.com/studio
175
-
176
- For now see [ Install] ( #Install ) .
177
-
178
182
# Support
179
183
180
184
For general help or to request a feature, see:
@@ -197,3 +201,4 @@ You can also support other related projects:
197
201
- [ Django Files Server] ( https://github.com/django-files/django-files )
198
202
- [ Django Files iOS App] ( https://github.com/django-files/ios-client )
199
203
- [ Django Files Android App] ( https://github.com/django-files/android-client )
204
+ - [ Django Files Web Extension] ( https://github.com/django-files/web-extension )
0 commit comments