Zipline Upload

• Install
  • Setup
• Features
  • Planned
  • Known Issues
  • Troubleshooting
• Screenshots
• Support
• Development
  • Building
• Contributing

Zipline Android Client Application to Upload, Share, Download and Manage Files and Short URLs for the Diced/Zipline v4 ShareX Upload Server. Includes a Native File List for Viewing, Editing and Downloading files locally. Plus User Management to edit Username, Password, Avatar, TOTP, and more...

Native Kotlin Android Application with a Mobile First Design. Everything is cached and images are not downloaded over metered connections unless enabled. User profile and stats widget are updated in the background with a user configurable task.

More information available on the website: https://zipline-android.cssnr.com/

We are also developing a browser addon for all major browsers including Firefox Android: Zipline Web Extension

Install

Note

Google Play is in Closed Testing. To be included see this discussion.

📲 Click to View QR Codes 📸 Supports Android 8 (API 26) 2017 +

Note: If installing directly, you may need to allow installation of apps from unknown sources.
For more information, see Release through a website.

View Manual Steps to Install from Unknown Sources

Note: Downloading and Installing the apk should take you to the settings area to allow installation if not already enabled. Otherwise:

1. Go to your device settings.
2. Search for "Install unknown apps" or similar.
3. Choose the app you will install the apk file from.
   • Select your web browser to install directly from it.
   • Select your file manager to open it, locate the apk and install from there.
4. Download the Latest Release.
5. Open the download apk in the app you selected in step #3.
6. Choose Install and Accept any Play Protect notifications.
7. The app is now installed. Proceed to the Setup section below.

Setup

Setup guides available on the website.

1. Install and open the app on your device.
2. Log in as you normally would on the website.
3. Done! You can now share and open files with Zipline.
4. Optionally add a Stats Widget to your Home Screen.

To use, share or open any file(s), text, or URL and choose the Zipline app.
Preview the item(s), set upload options, verify and submit.
The results will be shown and copied to the clipboard.

The Files List can be used to view, edit, download, or delete any file or files.

The User Page can be used to edit your profile, avatar, and execute server actions if administrator.

Tip

Please let us know if you run into any issues. All bugs that can be reproduced, will be fixed!

Features

Features are documented on the website.

• Share or Open any File, Media, Text or URL
• Preview, Edit and set Options before Uploading
• Native File List with Multi-Select, Edit and Delete
• User and Server Management Page with Avatar Cropper
• Home Screen Widget with File Stats and App Shortcuts
• User Configurable Background Update Task for Stats
• Supports Two-Factor Authentication and Custom Headers

Planned

• Update User Page UX
• Add Short URL Management
• Add AppBar to Replace Bottom Navigation
• Add Remaining Upload Options (ref: upload-options)
• Improve File List
  • Add Grid View Selector
  • Add Remaining File Options (ref: file)

Known Issues

• After deleting files and then scrolling in the file list it skips the number of files deleted when loading.
  • After deleting files, scroll to the top and pull down to refresh.
• If your sessions get deleted you are logged out of the WebView (Home).
  • The WebView is being deprecated and future updates will rely less on this.
• Android 8 (API 26-27) crashes when downloading a file due to a permissions error.
  • Single files can be downloaded from the Home WebView. No work around for bulk downloads.
• Please Open a New Issue if you don't see yours.

Troubleshooting

• Most navigation and display issues can be fixed by fully closing the app and restarting it.
  • If you encounter a reproducible issue please report it as a bug.
• If you encounter issues with the media in the file list, try clearing the application cache.
• If you encounter issues with authentication, try clearing the application data (resets settings and auth).
• If all of the above fail, try re-installing the application and let us know what happened.

If you are having trouble using the app, support is available via GitHub or Discord.

Screenshots

A slideshow is available on the website.

Support

Documentation Site: https://zipline-android.cssnr.com/

For general help or to request a feature, see:

• Q&A Discussion: https://github.com/cssnr/zipline-android/discussions/categories/q-a
• Request a Feature: https://github.com/cssnr/zipline-android/discussions/categories/feature-requests

If you are experiencing an issue/bug or getting unexpected results, you can:

• Report an Issue: https://github.com/cssnr/zipline-android/issues
• Chat with us on Discord: https://discord.gg/wXy6m2X8wY
• Provide General Feedback: https://cssnr.github.io/feedback/

Development

This section briefly covers running and building in Android Studio and the Command Line.

To update the Website/Docs go here: https://github.com/cssnr/zipline-android-docs

Building

To build the app you must first add a Google Services file and optionally prepare highlightjs.

1. Building this app requires a valid app/google-services.json file. For more info see Google Services.
2. To build the text preview run bash .github/scripts/prepare.sh or manually add highlightjs to:
   assets/preview/dist

Proceed to Android Studio or Command Line below.

Android Studio

1. Download and Install Android Studio: https://developer.android.com/studio
2. Ensure that usb or wifi debugging is enabled in the Android developer settings and verify.
3. Then build or run the app on your device.
   • Import the Project
   • Run Gradle Sync

To Run: Select a device and press Play ▶️

To Build:

• Select the Build Variant (debug or release)
• Build > Generate App Bundles or APK > Generate APKs

Command Line

Warning

This section is not complete. For more details on building see the release.yaml.

Ensure you both ADB and SDK Tools installed and accessible.

• Android Debug Bridge
• Android SDK Platform Tools

Build a release:

./gradlew assemble

Note: Use gradlew.bat for Windows.

Ensure device is connected:

$ adb devices
List of devices attached
RF9M33Z1Q0M     device

Install to device:

$ cd app/build/outputs/apk/debug
$ adb -s RF9M33Z1Q0M install app-debug.apk

Note: you may have to uninstall before installing due to different certificate signatures.

Google Services

Location: app/google-services.json

This app uses Firebase Google Services. Building requires a valid google-services.json file in the app directory.
You must add org.cssnr.zipline to a Firebase campaign here: https://firebase.google.com/

To enable/disable Firebase DebugView use the following commands:

# set
adb shell setprop debug.firebase.analytics.app org.cssnr.zipline

# unset
adb shell setprop debug.firebase.analytics.app .none.

# check
adb shell getprop debug.firebase.analytics.app

Only 1 app can be in debug mode at a time and this must be set every restart.

Note: Firebase is disabled in debug builds. See the manifestPlaceholders in the build.gradle.kts file debug config.

Contributing

All contributions are welcome including bug reports, feature requests, or pull requests (please start a discussion).

Zipline Projects

• Zipline Web Extension

• Zipline CLI - Only Supports v3

Related Projects

You can also star this project on GitHub and support other related projects:

• Django Files Server
• Django Files iOS App
• Django Files Android App
• Django Files Web Extension

Additional Android projects:

• NOAA Weather Android
• Remote Wallpaper Android
• Tibs3DPrints Android

Please consider making a donation to support the development of this project and additional open source projects.

For a full list of current projects visit: https://cssnr.github.io/