🚀 GeminiDesk: The Gemini Desktop App 🚀

Is Google Gemini just another browser tab in your sea of tabs? We fixed that.
GeminiDesk liberates the brilliant Google Gemini AI, giving it a proper home on your desktop. This is the native, feature-packed Gemini desktop app you've been searching for.

GeminiDesk transforms your AI interaction from a clumsy browser dance into a native desktop symphony. No more clutter. No more distractions. Just pure, unadulterated productivity with a sprinkle of magic.

✨ Why Your Google Gemini App Deserves a Throne ✨

GeminiDesk is more than a simple wrapper; it's a native command center for the Google Gemini AI. This desktop app is loaded with features that transform your workflow.

Screenshot to Chat

Instantly snip any part of your screen with a hotkey. The image is magically beamed into your chat, ready for Gemini's brilliant analysis. It's like having a conversation with your screen!

Universal File Drop

Drag and drop images, PDFs, text files—heck, almost any file—directly into the app. It's instantly ready for upload. The friction? Gone. The future? Now.

Instant Model Switching

Why click through menus like a peasant? Use dedicated hotkeys to instantly fire up a new chat with either the lightning-fast Flash model or the powerhouse Pro model.

Find That Chat... Instantly!

Lost a brilliant idea in the chat abyss? Hit the search hotkey to immediately focus the search bar and unearth your past conversations. Your brain will thank you.

Multi-Window Mania

Who said you can only have one conversation at a time? Open multiple windows and conquer multiple topics simultaneously. It’s organized chaos at its finest.

Always-On-Top Mode

Keep Gemini watching over your shoulder (in a non-creepy way) while you work. Perfect for coding, writing, or just feeling less alone in the universe.

Your Keys, Your Kingdom

Don't like our default hotkeys? No problem! Dive into the settings and remap every single shortcut to fit your unique, beautiful, and probably weird workflow.

Run on Startup

Have GeminiDesk greet you the moment your computer boots up. Because your AI assistant should be as ready to work as you are (or more so).

The Little Things

Persistent Login, Automatic Mic Permissions, and Smart, Non-Intrusive Updates. We've ironed out all the wrinkles so it just works.

Your App, Your Style

Choose between a sleek Dark mode, a clean Light mode, or let the app sync with your OS. Your eyes will thank you.

Canvas Mode

Need more space? Activate Canvas Mode to instantly expand the window to a larger, more comfortable size, perfect for deep dives and extensive conversations.

System Notifications

Receive important announcements and updates directly through a clean, native notification system. No more checking GitHub for news.

"Open With" Integration

Set GeminiDesk as the default application for images or text files. Opening a file with the app will instantly load it into the chat, ready for action.

Fullscreen & Custom Header

Go big with a dedicated fullscreen mode. The sleek, draggable header bar even shows your current chat's title, so you always know what you're working on.

⌨️ The Secret Handshakes (Default Shortcuts)

Access the magic from anywhere in your OS. (Remember, you can change ALL of these in the settings!)

Shortcut Action
Alt + GToggle App Visibility (Show / Hide)
Alt + NOpen a New Window
Alt + SSearch Chats Instantly
Control + Alt + SCapture Screenshot & Paste into Chat
Alt + PNew Chat with Pro Model
Alt + FNew Chat with Flash Model
Alt + RRefresh the active View
Alt + IShow Instructions / Onboarding Screen
Alt + QQuit Application (The "I'm Done" Button)

💾 Installation

Getting this slab of awesome onto your machine is laughably simple.

  1. Brave the digital seas and navigate to the Latest Release page.
  2. Download the correct file for your operating system:
    • Windows: Grab the ...Setup-x.x.x.exe file.
    • macOS: Snag the .dmg file.
  3. Follow the standard installation procedure for your OS:
    • Windows: Run the installer. Click 'Next' like you mean it.
    • macOS: Open the .dmg and drag the GeminiDesk icon into your Applications folder.

That's it! GeminiDesk is now a permanent resident on your desktop. Treat it well.

🛠️ For Developers: Building From the Ashes

Want to peek under the hood or forge your own version? We admire your courage.

Prerequisites

  • Node.js (v16 or higher is a good life choice)
  • Git

Get Started

1. Clone the legend:

git clone https://github.com/hillelkingqt/GeminiDesk.git
cd GeminiDesk

2. Install the ancient runes (dependencies):

npm install

3. Unleash the beast (run in dev mode):

npm start

4. Package it for the masses (build the installer):

npm run build

🤝 Let's Build a Dynasty

Contributions are the lifeblood of open source. If you have an idea that's so good it's scary, we want to see it.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/MindBlowingFeature)
  3. Commit your Changes (git commit -m 'Add some MindBlowingFeature')
  4. Push to the Branch (git push origin feature/MindBlowingFeature)
  5. Open a Pull Request and prepare for glory.