Skip to content

cssnr/zipline-android

Repository files navigation

GitHub Downloads GitHub Release Version Lint GitHub Top Language GitHub Last Commit GitHub Repo Size GitHub Discussions GitHub Forks GitHub Repo Stars GitHub Org Stars Discord

Zipline Android App

GitHub Release

Allows you to Share or Open any file and Shorten URLs with your Zipline v4 server. Shows a preview with custom options and copies the URL to the clipboard after upload.

  • Supports Android 8 (API 26) 2017 +

Install

Tip

To install, download and open the latest release.

GitHub Release

View QR Code 📸

QR Code

Note: Until published on the play store, you may need to allow installation of apps from unknown sources.

Downloading and Installing the apk should take you to the settings area to allow installation if not already enabled. For more information, see Release through a website.

View Manual Steps to Install from Unknown Sources
  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

  1. Install and open the app on your device.
  2. Log in as you normally would on the website.
  3. All Done! You can now share and open files with Zipline.

To use, share or open any file and choose the Zipline app. The app will then be upload the file to your Zipline server. Additionally, the URL is copied to the clipboard and the preview is show in the app.

Features

  • Share or Open any file or URL to your Zipline server.
  • Preview the file or URL with custom options before uploading.
  • Copies the URL to the clipboard after uploading and shows preview.
  • Shortcut to directly upload files from long press or shortcut icon.

Planned

  • Sharing multiple files at once.

Known Issues

Development

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

Android Studio

  1. Download and Install Android Studio.

https://developer.android.com/studio

  1. Ensure that usb or wifi debugging is enabled in the Android developer settings and verify.

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

Note: This section is a WIP! For more details see the release.yaml.

You will need to have ADB installed.

Click Here to Download and Install a Release
$ wget https://github.com/cssnr/zipline-android/releases/latest/download/zipline.apk
$ ls
zipline.apk

$ which adb
C:\Users\Shane\Android\sdk\platform-tools\adb.EXE

$ adb devices
List of devices attached
RF9M33Z1Q0M     device

$ adb -s RF9M33Z1Q0M install zipline.apk
Performing Incremental Install
Serving...
All files should be loaded. Notifying the device.
Success
Install command complete in 917 ms

See below for more details...

  1. Download and Install the Android SDK Platform Tools.

https://developer.android.com/tools/releases/platform-tools#downloads

Ensure that adb is in your PATH.

  1. List and verify the device is connected with:
$ adb devices
List of devices attached
RF9M33Z1Q0M     device
  1. Build a debug or release apk.
./gradlew assemble
./gradlew assembleRelease

Note: Use gradlew.bat for Windows.

  1. Then install the apk to your device with adb.
$ cd app/build/outputs/apk/debug
$ adb -s RF9M33Z1Q0M install app-debug.apk
$ cd app/build/outputs/apk/release
$ adb -s RF9M33Z1Q0M install app-release-unsigned.apk

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

For more details, see the ADB Documentation.

Support

For general help or to request a feature, see:

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

Contributing

Currently, the best way to contribute to this project is to star this project on GitHub.

You can also support other related projects: