Skip to content

stanlee000/spellbound

Repository files navigation

Spellbound - your multilingual AI-powered writing assistant

Just hit a shortcut for instant translations, grammar fixes, or text enhancements to supercharge your workflow.

AI writing power, everywhere you type

spellbound_screenhots_1

🌟 Why Spellbound?

As someone who didn't grow up speaking English, writing for work and social media used to mean bouncing between grammar checkers, style tools, and translation apps (Grammarly, Hemingway, Google Translate). It was a mess and slowed me down, especially in today's fast-paced, multinational world where you constantly need to live in different countries and switch languages.

One day, after yet another round of app-switching, I thought, "Why isn't there one tool that just does it all?" That's why I built Spellboundβ€”a simple app that sits in your tray and helps with grammar, style, and translations in seconds. Just highlight & copy your text, hit Cmd+Shift+C, and you're set.

It started as my personal fix, but now I'm excited to share it with anyone who wants to write better and faster, no matter what language you're working in. And yep, I used Spellbound to write this :)

✨ Features

  • Instantly analyze text: Press Hit Cmd+Shift+C (Mac) or Ctrl+Shift+C (Win/Linux)
  • Translate on the fly: Cmd+Shift+T (Mac) / Ctrl+Shift+T (Win/Linux)
  • Context magic: App pops up right by your cursor
  • Multilingual & always readyβ€”no limits
  • Enhance for any platform:
    • 🐦 Twitter/X
    • πŸ’Ό LinkedIn
    • πŸ“Έ Instagram
    • πŸ’» Hacker News
    • 🎯 Reddit
    • πŸͺ„ AI prompts builder
    • ✍️ Custom tones
  • Cross-Platform: Runs on Mac, Windows, and Linux. Browser extensions available for:
  • Privacy-First: Your API key never leaves your device
  • Custom keyboard shortcuts for your style
  • Language Detection

πŸ‘‡ Experience Spellbound β€” just toggle

Spellbound suggestions showcase Spellbound Translations showcase
Spellbound prompt building showcase Spellbound enhance text showcase

πŸš€ Getting Started

  1. Launch in minutes

    • Download the latest version from the Releases, install, and launch Spellbound
    • Grab your OpenAI API key, pop it into Spellbound, and pick GPT-4.1 or 4o
  2. Start Using

    • Highlight & copy (Cmd + C) any text in any app
    • Hit Cmd+Shift+C (Mac) or Ctrl+Shift+C (Windows/Linux) for instant suggestion
    • Need a translation? Just use Cmd+Shift+T (Mac) or Ctrl+Shift+T (Windows/Linux)
    • Watch your writing transform!
  3. Browser Extensions

πŸ’‘ Pro Moves

  • Use the tray icon for lightning-fast settings access
  • Experiment with enhancement modes to supercharge any writing style
  • Customize your shortcut for ultimate speed
  • Seamlessly translate text and conquer any language barrier

πŸ›  Technical Details

System Requirements

  • OS: macOS 10.13+, Windows 10+, or Linux
  • Storage: 200MB free space
  • Internet: Required for API connectivity
  • Safari Extension: macOS 11+ and Xcode 12+ (for building)

Built With

  • Electron
  • OpenAI API
  • React
  • Material-UI
  • Safari Web Extensions (for Safari version)

πŸ”’ Privacy & Security

  • Your OpenAI API key is stored locally using electron-store
  • No data is stored on external servers
  • All text processing happens through your personal OpenAI account
  • No tracking or analytics included

🀝 Contributing

We welcome contributions! Here's how you can help:

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Troubleshooting

Common Issues:

  1. API Key Not Working

    • Verify your OpenAI API key is correct
    • Check your internet connection
    • Ensure you have billing set up on your OpenAI account
  2. Shortcut Not Responding

    • Check if another app is using the same shortcut
    • Try restarting the application
    • Verify the shortcut in settings
  3. Window Not Appearing

    • Make sure text is selected
    • Check if the app is running in the system tray
    • Try restarting the application

πŸ“¬ Support

Having issues? Check out our Issues page or create a new issue.

πŸ—Ί What's Next?

  • πŸ“± Mobile App: Take Spellbound anywhere, anytime!
  • 🌐 Browser Extensions:
  • πŸ”„ Next-level Text Tools: Select, edit, and enhance in a snap.
  • 🎯 Smart Templates: Save and reuse go-to prompts.
  • 🎀 Voice Input: Speak, create, and wow in real time.
  • 🀝 Team Power: Share styles and templates effortlessly.
  • πŸ”— More AI: Plug into top models like Claude, Gemini & your own!

Community Suggestions

Got a cool feature idea or something you'd like to see? Drop your suggestion or vote for your favorites or if you're interested in getting involved, always open to new collaboratorsβ€”let's build it together!


Made with ❀️

Support this project β€’ Report Bug β€’ Request Feature