mirror of
https://github.com/TheAnachronism/docspell.git
synced 2025-06-23 10:58:26 +00:00
Initial doc for new android app
This commit is contained in:
87
website/site/content/docs/tools/android.md
Normal file
87
website/site/content/docs/tools/android.md
Normal file
@ -0,0 +1,87 @@
|
||||
+++
|
||||
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).
|
Reference in New Issue
Block a user