f0ckm-uploader/android

fuggloader Android Integration

This directory contains solutions to integrate fuggloader directly into the Android System Share Menu.

Features

• Native Android App: A lightweight wrapper that provides a "Share" target for images, videos, and URLs.
• Automatic Clipboard: Copies the generated post link directly to the Android Clipboard upon completion.
• Configurable Settings: Store API Endpoint URL, API Key, default rating (sfw/nsfw/nsfl), tags, and visibility.

How to Build & Install

1. Open the android/ directory in Android Studio.
2. Connect your Android phone via USB debugging or start an emulator.
3. Build & Run the project (or run ./gradlew assembleDebug to build app-debug.apk).
4. Launch fuggloader Uploader on your phone:
   • Enter your API URL (https://your-fuggloader-site.com/api/v2/upload)
   • Enter your API Key
   • Tap Save Settings -> Test Connection.
5. Open any image/video in your Gallery, or any URL in Chrome -> Tap Share -> Select Upload to fuggloader!

---

Option 2: HTTP Shortcuts App (Zero Compilation Needed)

If you don't want to build an Android app manually, you can use the free open-source app HTTP Shortcuts (or from F-Droid).

Quick Setup:

1. Install HTTP Shortcuts from Google Play or F-Droid.
2. Open HTTP Shortcuts -> Tap menu (3 dots) -> Import / Export -> Import from file.
3. Select android/http-shortcuts-recipe.json.
4. Edit the imported shortcut:
   • Change https://YOUR_SITE.com/api/v2/upload to your API URL.
   • Set header X-Api-Key to your API Key.
5. Save the shortcut. Now "Upload File to fuggloader" and "Upload URL to fuggloader" will appear in your native Android Share menu!

---

Option 3: Web Share Target (PWA)

If you host the fuggloader web frontend, you can add a share_target entry to manifest.json:

{
  "name": "fuggloader",
  "short_name": "fuggloader",
  "start_url": "/",
  "display": "standalone",
  "share_target": {
    "action": "/api/v2/upload",
    "method": "POST",
    "enctype": "multipart/form-data",
    "params": {
      "title": "title",
      "text": "text",
      "url": "url",
      "files": [
        {
          "name": "file",
          "accept": ["image/*", "video/*", "*/*"]
        }
      ]
    }
  }
}

When users visit your fuggloader web app on Android Chrome and tap "Add to Home Screen", Android automatically registers it to the native Share menu.