mirror of
https://github.com/TheAnachronism/docspell.git
synced 2024-11-13 02:31:10 +00:00
88 lines
2.8 KiB
Markdown
88 lines
2.8 KiB
Markdown
|
+++
|
||
|
|
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).
|