Skip to content
This repository was archived by the owner on Apr 19, 2026. It is now read-only.

README.md

Latest commit

 

History

History
58 lines (48 loc) · 1.73 KB

README.md

File metadata and controls

58 lines (48 loc) · 1.73 KB

Gemini Quick Launcher

⚠️

Google now ships an official Gemini desktop app for macOS. Please use it instead:

👉 https://gemini.google/mac/

A cross-platform desktop quick launcher for Gemini built with Electron.

Features

  • Global Shortcut: Control+Space (macOS), Ctrl+Space (Windows/Linux)
  • Frameless Window: Centered around the active cursor display.
  • Smart Focus: Auto-hides when Escape is pressed or window loses focus (blur).
  • Session Preserved: Google Login context persists between launches.
  • Single Instance: Prevents multiple windows from being opened simultaneously.

Step-by-Step Setup Instructions

1. Requirements

  • Node.js installed (v16.0.0 or higher recommended)
  • npm installed

2. Installations

Go to the project folder where the code resides, or open a terminal there and run:

npm install

3. Running the App

To start the application locally:

npm start

The app will launch in the background. Press Control+Space (macOS) or Ctrl+Space (Windows/Linux) to bring up the window.

4. Packaging the App (Production)

You can package the application using the integrated electron-builder configuration for different platforms:

macOS

npm run dist -- --mac

An executable .dmg or .app will be generated in the dist folder.

Windows

npm run dist -- --win

A .exe installer will be generated in the dist folder.

Linux

npm run dist -- --linux

An .AppImage will be generated in the dist folder.

5. To Note

The application creates a frameless transparent window. Any links navigating outside Gemini or Google Sign-in will open natively in your default OS browser to ensure security.