Skip to content

About

Android image sharing app: browse, annotate, and upload to S3, Imgur, FTP, SFTP

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Repository files navigation

XerahS logo

XerahS for Android

Capture. Upload. Share in a tap.
A ShareX-style uploader for Android.

Latest release Android 8.0 or newer GPL-3.0

Website · Download · Setup guides · FAQ · Report a bug

Home with recent uploads The editor A finished upload with its link Appearance settings

Pick a screenshot or any other file, mark it up if you want, and send it to Imgur, your own S3 bucket, Nextcloud or a server you run. When the upload finishes, the link is already on your clipboard.

Note

XerahS for Android is unofficial. It's inspired by XerahS and ShareX but isn't affiliated with or endorsed by either project, and it uses none of their code. It's also still early, so expect the odd rough edge.

Install

Download the APK from the latest release on your phone and open it. If Android asks, allow installs from your browser. New versions show up in the app under Settings, Updates.

You need Android 8.0 or newer. If Android warns about unknown apps or something else looks off, the FAQ covers the usual questions.

What it does

Upload anything. Images, PDFs, videos and other files. Share a file, a link or some text into XerahS from another app, use the Quick Settings tile or the home-screen widget, or pick from your gallery. Several files can go up in one batch, and the upload queue shows each one, with cancel and retry.

Start from wherever you are. Long-press the app icon for New upload, Upload clipboard and Copy last link. Your upload profiles show up in Android's share sheet, so sharing to one skips the destination picker. Turn on screenshot uploads and each new screenshot gets a notification with Upload and Edit, or goes straight up if you prefer.

Links and text too. Share a link into XerahS to shorten it, upload the file it points to, or upload it as text. Anything you've copied can be uploaded from Home.

Mark it up first. The editor has twelve tools: rectangle, ellipse, line, arrow, freehand, text, numbered steps, blur, pixelate, highlight, spotlight and a magnifier. You can crop, rotate and flip, add a border or shadow, and pull text out of an image with on-device OCR.

Send it where you want. Each destination keeps its own settings, and upload profiles let you switch between setups in one tap.

Destination Notes
Imgur Anonymous uploads with your own Client ID
Amazon S3 Also Cloudflare R2, MinIO, DigitalOcean Spaces and other S3-compatible storage
Nextcloud Uploads to a folder and creates a share link
Immich Sends photos and videos to your library
GitHub Gist For text and code
FTP and FTPS Passive mode, creates folders as needed
SFTP Password or SSH key
Custom uploaders Import ShareX .sxcu files, including {json:}, {regex:}, {xml:} and input prompts. Presets for XBackBone, Pastebin and Bitly
On your phone Saves locally

Setup steps for every destination, with the exact field names from the app, are in the guides. Images, text and other files can each go to a different profile automatically.

Decide what happens next. Copy the link, open the share sheet, open it in the browser or show a QR code, per profile or for every upload. Links can be copied as a plain URL, Markdown, HTML or BBCode, and shortened with is.gd or your Bitly account.

Find it again later. History keeps every upload with its link, host and thumbnail. Search it, sort uploads into albums and tags, and delete a file from the host when you're done with it. Upload the same image twice and XerahS offers the link you already have.

Browse your bucket. The S3 explorer lists, searches, renames, moves and downloads files. GIFs animate and videos play in the preview, and there's a stats view with storage use and a cost estimate.

A few extra tools. The beautifier puts a screenshot on a gradient with padding, rounded corners and a shadow. The combiner stitches up to 20 images into one. You can also resize or convert a batch of images and add a watermark, read a QR code from a picture, check a file's hash, or pick a color from an image.

Make it look how you like. Light, dark or system theme, seven accent colors or your own, Material You, and a true black mode for OLED screens. Every accent goes through a contrast check, so text stays readable.

Keep it private. No analytics and no account. Passwords and keys stay in Android's encrypted storage and are left out of Android backups. XerahS's own backups are encrypted with a passphrase you pick, and you can lock the app behind your fingerprint. The privacy page lists what's stored and every request the app makes.

Build it yourself

You need JDK 17 or newer and the Android SDK.

./gradlew assembleDebug
adb install app/build/outputs/apk/debug/app-debug.apk

The app is written in Kotlin with Jetpack Compose and follows a multi-module layout where app depends on feature/* and features depend on core/*. Features never depend on each other.

app/            Navigation, theme, main activity
core/common     Color engine, AWS signing, .sxcu parsing, utilities
core/domain     Models and repository interfaces
core/data       Room, DataStore, encrypted credentials, uploaders
core/ui         Shared Compose components
feature/        capture, annotation, upload, history, s3explorer, tools, settings
site/           The website, deployed to GitHub Pages

It uses Hilt, Room, WorkManager, DataStore, OkHttp, Coil, Media3, ML Kit and ZXing. The fonts are Inter, Inter Tight and JetBrains Mono, all under the SIL Open Font License.

Contributing

Bug reports and pull requests are welcome. If you're planning something big, open an issue first so we can talk it through.

License

GPL-3.0

About

Android image sharing app: browse, annotate, and upload to S3, Imgur, FTP, SFTP

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages