System-wide AI text assistant for Android — powered by Gemini, Groq, and any OpenAI-compatible endpoint

Type a trigger like ?fix at the end of any text, in any app, and watch it get replaced — instantly.

     

[!NOTE] SwiftSlate works in most apps — WhatsApp, Gmail, Twitter/X, Messages, Notes, and more. No copy-pasting. No app switching. Just type and go. Some apps with custom input fields may not be supported (see limitations).

📋 Table of Contents

• Quick Demo
• Features
• Built-in Commands
• Text Replacer Commands
• Supported AI Providers
• Getting Started
• How It Works
• Custom Commands
• API Key Management
• Backup & Restore
• App Screens
• Screenshots
• Localization
• Privacy & Security
• Tech Stack
• Architecture
• Building from Source
• Contributing
• Sponsors
• Support the Project
• License
• Star History

⚡ Quick Demo

📝  You type       →  "i dont no whats hapening ?fix"
⏳  SwiftSlate      →  ◐ ◓ ◑ ◒  (processing...)
✅  Result         →  "I don't know what's happening."

📝  You type       →  "hey can u send me that file ?formal"
⏳  SwiftSlate      →  ◐ ◓ ◑ ◒  (processing...)
✅  Result         →  "Could you please share the file at your earliest convenience?"

📝  You type       →  "Hello, how are you? ?translate:es"
⏳  SwiftSlate      →  ◐ ◓ ◑ ◒  (processing...)
✅  Result         →  "Hola, ¿cómo estás?"

✨ Features

🧩 Built-in Commands

SwiftSlate ships with 9 AI-powered commands plus dynamic translation — ready to use out of the box:

🛠️ Text Replacer Commands

Beyond AI, you can create text replacer commands that run entirely offline — no API key, no network, instant execution:

[!TIP] Text replacer commands execute instantly with zero latency — no spinner, no network call. Create them in the Commands tab by selecting the "Text Replacer" type.

🤖 Supported AI Providers

[!TIP] For local LLMs, set the endpoint to your machine's local address (e.g., http://localhost:11434/v1 for Ollama). HTTP is allowed for localhost, 127.0.0.1, and 10.0.2.2.

🚀 Getting Started

Prerequisites

Installation

[!TIP] The APK is only ~1.2 MB — lightweight with zero external dependencies for networking or JSON.

1. Download the latest APK from the Releases page

2. Install the APK on your device (allow installation from unknown sources if prompted)

3. Open SwiftSlate and follow the setup below

Setup in 3 Steps

⚙️ How It Works

flowchart TD
    A["📝 You type: 'Hello wrld, how r u ?fix'"] --> B{"🔍 Accessibility Service\ndetects trigger"}
    B -- "Text Replacer" --> C["⚡ Instant local replacement\n(no network call)"]
    B -- "AI Command" --> D["🔑 Selects next API key\n(round-robin)"]
    D --> E["🤖 Sends text + prompt\nto AI provider"]
    E --> F["⏳ Shows inline spinner\n◐ ◓ ◑ ◒"]
    F --> G["✅ Replaces text in-place"]
    C --> G

    style A fill:#1a1a2e,stroke:#e94560,color:#fff
    style B fill:#1a1a2e,stroke:#0f3460,color:#fff
    style C fill:#1a1a2e,stroke:#00b894,color:#fff
    style D fill:#1a1a2e,stroke:#0f3460,color:#fff
    style E fill:#1a1a2e,stroke:#0f3460,color:#fff
    style F fill:#1a1a2e,stroke:#e94560,color:#fff
    style G fill:#16213e,stroke:#00b894,color:#fff

🎨 Custom Commands

Create, edit, and manage your own commands in the Commands tab.

Two Types of Custom Commands

Example AI Command Ideas

[!TIP] Just describe the transformation you want — SwiftSlate's system instruction automatically ensures the AI returns only the transformed text without extra commentary.

🔑 API Key Management

SwiftSlate supports multiple API keys with intelligent rotation:

[!TIP] Adding 2–3 API keys from different accounts helps avoid rate limits during heavy use. On the free tier, all keys under the same account share a single quota — so rotation only helps with keys from separate accounts.

💾 Backup & Restore

Export and import your custom commands as JSON files — useful for migrating to a new device or sharing command sets.

• Export — Saves all custom commands to a .json file via Android's file picker
• Import — Loads commands from a .json file (validates format, trigger prefix, and size limits before importing)

Find both options in the Settings tab under Backup & Restore.

[!NOTE] Imported commands must use the same trigger prefix currently configured in the app. API keys are not included in backups for security.

🖥️ App Screens

SwiftSlate has four screens accessible via the bottom navigation bar:

📸 Screenshots

Dark Mode

Light Mode

🌍 Localization

SwiftSlate's UI is available in 7 languages:

The app automatically uses your device's language. Contributions for additional translations are welcome!

🔒 Privacy & Security

[!NOTE] SwiftSlate is built with privacy as a core architectural principle, not an afterthought.

🏗️ Tech Stack

Zero third-party dependencies for networking or JSON parsing — SwiftSlate uses only Android's built-in APIs.

🏛️ Architecture

com.musheer360.swiftslate/
├── service/
│   └── AssistantService.kt      # Core accessibility service — event listening,
│                                 # trigger detection, text replacement, inline spinner
├── api/
│   ├── GeminiClient.kt          # Google Gemini API client
│   ├── OpenAICompatibleClient.kt # Unified client for Groq + any OpenAI-compatible endpoint
│   └── ApiClientUtils.kt        # Shared utilities — response parsing, error handling,
│                                 # structured output extraction, system prompt
├── manager/
│   ├── KeyManager.kt            # AES-256-GCM encrypted key storage, round-robin rotation,
│   │                            # rate-limit tracking, invalid key detection
│   └── CommandManager.kt        # Command CRUD, trigger matching (longest-match),
│                                # prefix migration, import/export
├── model/
│   ├── Command.kt               # Command data class (AI or Text Replacer)
│   └── ProviderType.kt          # Provider constants (gemini, groq, custom)
├── ui/
│   ├── DashboardScreen.kt       # Service status, key count, quick-start guide
│   ├── KeysScreen.kt            # API key management with live validation
│   ├── CommandsScreen.kt        # Command list, add/edit/delete with collapsible form
│   ├── SettingsScreen.kt        # Provider, model, prefix, backup/restore
│   ├── components/              # Reusable UI components (cards, text fields, dividers)
│   └── theme/Theme.kt           # AMOLED dark + light Material 3 color schemes
├── MainActivity.kt              # AnimatedContent tab navigation (4 tabs)
├── SwiftSlateViewModel.kt       # Shared ViewModel exposing managers + prefs
└── SwiftSlateApp.kt             # Application class — SharedPreferences pre-warming

🔨 Building from Source

Prerequisites

• Android Studio (latest stable)
• JDK 17+
• Android SDK with API level 36

Build

# Clone the repository
git clone https://github.com/Musheer360/SwiftSlate.git
cd SwiftSlate

# Build debug APK
./gradlew assembleDebug

# Output: app/build/outputs/apk/debug/app-debug.apk

Install on device

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

export KEYSTORE_FILE=/path/to/your/keystore.jks
export KEYSTORE_PASSWORD=your_keystore_password
export KEY_ALIAS=your_key_alias
export KEY_PASSWORD=your_key_password

./gradlew assembleRelease

⚠️ Known Limitations

• Some apps use custom input fields that don't support Android's standard text replacement APIs. SwiftSlate includes a clipboard-based fallback, but apps like WeChat and Chrome's address bar may still not work. Most standard text fields (messaging apps, email composers, notes, etc.) work fine.
• Some OEMs restrict accessibility services. Certain manufacturers (e.g., OnePlus, Xiaomi) may hide or block third-party accessibility services in their settings UI. If SwiftSlate doesn't appear in your accessibility settings, check for a "Downloaded apps" or "Installed services" section, or try searching for it.

🤝 Contributing

Contributions are welcome! Here's how to get involved:

# 1. Fork the repository, then:
git clone https://github.com/YOUR_USERNAME/SwiftSlate.git
cd SwiftSlate

# 2. Create a feature branch
git checkout -b feature/amazing-feature

# 3. Make your changes and commit
git commit -m "Add amazing feature"

# 4. Push and open a Pull Request
git push origin feature/amazing-feature

Ideas for Contributions

• 🧩 New built-in commands
• 🤖 Additional AI provider integrations
• 🎨 UI improvements and new themes
• 🌍 Translations for more languages
• 📖 Documentation improvements

💜 Sponsors

SwiftSlate is made possible by the generous support of its sponsors. Thank you!

@lifearien

Want to see your name here? Become a sponsor →

❤️ Support the Project

SwiftSlate is free, open source, and built in my spare time. If it's useful to you, consider supporting its development:

• ⭐ Star this repo — it helps others discover SwiftSlate
• 💖 Sponsor on GitHub — even a small contribution keeps the project going

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

📈 Star History