Note to self: "Hello Me" 💚

Personal link stash tool for Android (currently). Save links and images from anywhere, store them your way. https://talofa.me

talofa.me is a lightweight Android app that lets you capture and store links, screenshots, and text snippets to your own server. Think of it as your personal pocket for everything you find interesting while browsing, reading, or exploring on your phone.

Who's it for?

• Developers building personal knowledge bases
• Anyone who collects links for later reference
• People who want control over their saved content
• Users building presentation notes, readme lists, or research collections

What makes it special?

• No ads, no tracking, just your stuff
• Share to your own server (or localhost!)
• Optional grouping and categorization
• Works with any backend you build

• Text & Links: Share URLs, articles, quotes, anything text-based
• Images: Share screenshots and photos directly 📸
• Groups: Optionally categorize shares into groups (work, personal, etc.)
• Self-Hosted: Point it at your server, no middleman
• API-First: Build automation, CICD triggers, markdown generators, whatever you want
• HTTP Support: Perfect for local development and self-hosted setups
• QR Code Setup: 📱 Scan a QR code to instantly configure the app
• Smart Protocol Detection: Enter URLs without https:// - the app tries HTTPS first, then HTTP automatically

1. Download the APK from releases
2. Enable "Install from unknown sources" on your Android device
3. Install the APK

Or build it yourself - see BUILDING.md

Option 1: Manual Setup

1. Open talofa.me
2. Enter your server URL (e.g., 192.168.1.100:8000 or talofa.me/api/config)
   • Protocol is optional! Just enter the domain and the app will try HTTPS first, then HTTP
3. Optionally add an API key
4. Tap Setup ✅

Option 2: QR Code Setup 📱

1. Scan a setup QR code with your camera app
2. Tap the notification to open talofa.me
3. Setup runs automatically!

Generate QR codes with format: talofa://setup?url=YOUR_CONFIG_URL&key=OPTIONAL_KEY See QR Code Setup Guide for details.

Tap share in any app → Select "talofa.me" → Done! Your link/image is saved to your server.

For Personal Use:

• Build a reading list from articles you find
• Save screenshots of inspiration
• Collect receipts and documents
• Bookmark recipes while scrolling

For Developers:

• Auto-generate changelog entries from shared commits
• Build a personal documentation site from saved links
• Trigger CICD workflows from shared content
• Create markdown-formatted collections automatically

For Research:

• Organize sources by project groups
• Save quotes and references instantly
• Build bibliographies from shared papers
• Keep track of resources per topic

talofa.me needs a companion server to receive your shares. You can:

• Run the example server (coming soon)
• Build your own with any framework (Django, Flask, Express, etc.)
• Point it at a simple webhook
• Deploy to Vercel, Railway, or your preferred host

See docs/dev/API_FLOW.md for the API specification.

• Browser extension
• Web interface for managing saved content
• Public API for third-party integrations
• More share types (files, multiple images)

The goal: give you every way to push content into your personal space, your rules.

• API Flow - How the app communicates with your server
• QR Code Setup - Configure the app by scanning QR codes
• Building - Compile and customize the app
• More docs coming as features develop

Scan a QR code to instantly configure the app! Perfect for:

• Quick setup across multiple devices
• Sharing your server setup with friends/team
• Onboarding without manual URL entry

Generate setup QR codes with format:

talofa://setup?url=https://your-server.com/api/config&key=your-api-key

See the QR Code Setup Guide for examples, security tips, and server-side implementation.

No more typing https:// or http:// - just enter your domain:

• Enter: talofa.me/api/config
• App tries: https://talofa.me/api/config first
• Falls back to: http://talofa.me/api/config if HTTPS fails
• Saves whichever protocol worked

Still want to force a specific protocol? Just include it explicitly:

• https://example.com - uses HTTPS only
• http://192.168.1.100 - uses HTTP only

Perfect for development and production workflows!

This is a personal tool made shareable. PRs welcome! Keep it simple, keep it focused.

MIT - see LICENSE