+++
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.

The project lives at a [repository on
github](https://github.com/docspell/android-client). It is planned to
be available from the [F-Droid](https://f-droid.org) store, meanwhile
download the APK from
[here](https://github.com/docspell/android-client/releases/latest).


# 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).