+++ title = "Android Client" description = "A simple Android App to upload files from your devices." weight = 20 +++ # Android Client There is a simple Android App available to conveniently upload files from your android devices. Combined with a scanner app, this allows to very quickly scan single page documents like receipts. <div class="columns is-vcentered is-centered"> <div class="column"> <a href="https://f-droid.org/packages/org.docspell.docspellshare"> <img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" style="height:120px;"/> </a> </div> <div class="column"> Download the APK from <a href="https://github.com/docspell/android-client/releases/latest">here</a> </div> </div> The project lives at this [repository on github](https://github.com/docspell/android-client). # Usage The app is very simple: - You maintain a list of upload URLs. These can be inserted conveniently by scanning the QR code. You need to create these upload urls at docspell as described [here](@/docs/webapp/uploading.md#anonymous-upload). - Start this app on your device and add a new URL - Then start some other app, and try to share a file. The *Share with* or *Open with* dialog should contain now the docspell app. Choose it. - You can now either select an URL from the app, or the upload begins immediatly if you set a default URL. <div class="columns"> <div class="column"> {{ imgnormal(file="screenshot-create.jpg", width="") }} <p class="has-text-centered subtitle"> (A) </p> </div> <div class="column"> {{ imgnormal(file="screenshot-choose.jpg", width="") }} <p class="has-text-centered subtitle"> (B) </p> </div> <div class="column"> {{ imgnormal(file="screenshot-options.jpg", width="") }} <p class="has-text-centered subtitle"> (C) </p> </div> </div> <div class="columns"> <div class="column"> {{ imgnormal(file="screenshot-default.jpg", width="") }} <p class="has-text-centered subtitle"> (D) </p> </div> <div class="column"> {{ imgnormal(file="screenshot-share.jpg", width="") }} <p class="has-text-centered subtitle"> (E) </p> </div> <div class="column"> {{ imgnormal(file="screenshot-uploading.jpg", width="") }} <p class="has-text-centered subtitle"> (F) </p> </div> </div> ## Create an URL Add a new one With the *Plus* button. The name (A-1) is to distinguish it in the list. The url (A-2) is used to upload files. You can add multiple URLs. You can give permissions to access the camera and use (A-3) to scan a QR code from the screen. ## Edit and Default Tapping an item in the list switches the view that shows some options. You can set one URL as the default (C-1). When uploading a file, the screen to choose an URL is skipped then and the file is uploaded immediately. Other actions are editing the url (C-2), going back (C-3) or deleting the item (4). The screen (D) shows a default URL with a green background. ## Upload Use some other app, for example OpenNoteScanner, and share the resulting files using the *Share With* menu (E). Then this app opens and uploads the file to your server (F).