Grok-Desktop v1.2.5

Description

Grok-Desktop is an Electron-based desktop application for Windows 10/11 and Linux that wraps grok.com, providing desktop-application-like access to Grok with real-time API usage monitoring, multi-tab support, and seamless authentication for xAI, Google, and Apple accounts.

Screenshot

Features

• Desktop application wrapper for grok.com
• Tabs functionality for multiple Grok conversations
• Real-time Usage Monitoring - Track your Grok usage limits:
  • Low Effort: Basic query limits and remaining tokens
  • High Effort: Advanced feature usage tracking
  • Grok 4 Heavy: Specialized model usage limits
  • Refill Timer: Shows when limits reset
• Keyboard shortcuts:
  • Ctrl+T: Open a new tab
  • Ctrl+Tab / Ctrl+Shift+Tab: Cycle through open tabs (next/previous)
  • Mouse-wheel-scroll: Scroll open tabs when they are overflowing on the tab bar
  • Ctrl+Mouse-wheel-scroll: Cycle through open tabs (next/previous)
  • Ctrl+R: Reload the active tab
  • Ctrl+I: Show information/about dialog
• Authentication support for xAI, Google, and Apple accounts
• Clean interface with no menu bar for distraction-free usage
• Always-on-top function with cross-platform support (Windows & Linux)
• Dark/Light mode support with system theme detection
• Grok speech mode support
• Enhanced security with domain validation and OAuth protection

Download

Windows

• Grok-Desktop_Installer-v1.2.5.exe - Windows installer (EXE)
• Grok-Desktop_Installer-v1.2.5.msi - Windows installer (MSI)
• Grok-Desktop_Portable-v1.2.5.exe - Portable Windows executable
• Grok-Desktop_Windows-v1.2.5.zip - Windows ZIP archive

Linux

• Grok-Desktop-v1.2.5.deb - Debian/Ubuntu package
• Grok-Desktop-v1.2.5.rpm - RPM package (RHEL/Rocky Linux/Fedora)
• Grok-Desktop_Linux-v1.2.5.tar.gz - Linux tar.gz archive
• Grok-Desktop_Linux-v1.2.5.7z - Linux 7z archive

System Requirements

For Using the Application

• Operating System: Windows 10/11 or Linux (Rocky Linux 9/10, RHEL 9, Ubuntu, Fedora, etc.)
• Internet connection for accessing grok.com
• Grok account (sign up in-app or use Google/Apple/xAI authentication)
• Linux AOT (Always-on-Top) requirement: Install wmctrl for Always-on-Top functionality:
  • Rocky Linux/RHEL/Fedora: sudo dnf install wmctrl
  • Ubuntu/Debian: sudo apt install wmctrl

For Building from Source

• Operating System: Windows 10/11 or Linux
• Node.js: LTS version (20.x recommended)
• Internet connection for downloading dependencies

Project Structure

Grok-Desktop/
├── src/                    # Main Electron application code
│   ├── main.js            # Main Electron process
│   ├── preload.js         # Preload script for renderer security
│   ├── renderer.js        # Renderer process code
│   ├── custom-tabs.js     # Custom tabs implementation
│   ├── grok.ico           # Windows application icon
│   └── grok.png           # Linux application icon
├── assets/                # Static assets
│   ├── icon.png
│   └── icon.svg
├── build-resources/       # Build configuration and resources
│   ├── icons/            # Application icons for different sizes
│   ├── after-install.sh  # Post-installation script
│   ├── after-remove.sh   # Post-removal script
│   └── com.grok.desktop.metainfo.xml  # App metadata for Linux
├── index.html            # Main application HTML
├── styles.css            # Application styles
├── about.html            # About dialog HTML
├── package.json          # Node.js dependencies and build config
├── build.bat             # Windows build script
├── build-linux.sh        # Linux build script
├── CHANGELOG.md          # Version history and changes
├── LINUX_BUILD_GUIDE.md  # Detailed Linux build instructions
├── new_features.md       # Security features documentation
└── README.md            # This file

<<<<<<< HEAD

Build Grok-Desktop

1. Install Node.js from nodejs.org.
2. Clone this repository or download the files.
3. Install dependencies if needed: npm install
4. Build using npm scripts:
   • Directory build (unpacked): npm run build-dir
   • Portable executable: npm run build-portable
   • Full installers (NSIS + MSI): npm run build-installer

Notes:

• These scripts use npx electron-builder@latest (no global install required).
• All build outputs are written to the build directory.

Usage

• After building, install Grok-Desktop with Grok-Desktop_Installer-v1.2.3.exe from the build directory
• Launch Grok-Desktop from the Start Menu
• Log in via grok.com, using Google, Apple, or xAI authentication as needed.
• Use the + button in the top toolbar (or Ctrl+T) to add new tabs.
• Click the AOT button in the top right to toggle always-on-top functionality.
• Use keyboard shortcuts to work faster:
  • Ctrl+T: Open a new tab
  • Ctrl+Tab / Ctrl+Shift+Tab: Cycle through open tabs (next/previous)
  • Ctrl+R: Reload the currently active tab
  • Ctrl+I: Show information/about dialog

Keyboard Shortcuts

• Ctrl+T: Open a new tab
• Ctrl+Tab: Switch to the next tab
• Ctrl+Shift+Tab: Switch to the previous tab
• Ctrl+R: Reload the active tab (does not reload the entire app window)
• Ctrl+I: Show information/about dialog =======

Building from Source

Prerequisites

1. Install Node.js LTS (20.x recommended) from nodejs.org
2. Clone this repository: git clone https://github.com/AnRkey/Grok-Desktop.git
3. Navigate to the project: cd Grok-Desktop
4. Install dependencies: npm install

Build Commands

development

Windows

# Full installer (NSIS + MSI)
npm run build-installer

# Portable executable
npm run build-portable

# Directory build (unpacked)
npm run build-dir

Linux

# RPM + AppImage packages
npm run build-linux

# RPM only for RHEL/Rocky Linux
npm run build-rhel

# All platforms (Windows + Linux)
npm run build-all

Notes:

• All scripts use npx electron-builder@latest (no global installation required)
• Build outputs are written to the build/ directory
• For detailed Linux build instructions, see LINUX_BUILD_GUIDE.md

Installation

Windows

1. Download and run Grok-Desktop_Installer-v1.2.5.exe from the releases page
2. Follow the installation wizard
3. Launch "Grok Desktop" from the Start Menu

Linux

RPM Package (Recommended for RHEL/Rocky Linux)

cd build
sudo dnf install ./Grok-Desktop-v1.2.5.x86_64.rpm

Usage Guide

Getting Started

1. Launch Grok-Desktop from your applications menu or desktop shortcut
2. Sign in to grok.com using your xAI, Google, or Apple account
3. The application opens with your first Grok tab

Interface Overview

• Tab Bar: Create and switch between multiple Grok conversations
• Navigation Controls: Back/forward buttons, reload, and URL bar
• Toolbar Buttons:
  • +: Create new tab
  • ↻: Reload current tab
  • AOT: Toggle always-on-top mode
  • s: Toggle API usage statistics display
  • 👁: Toggle Grok-4-Heavy stats visibility (eye icon)
  • i: Show about dialog

API Usage Monitoring

Grok-Desktop includes real-time monitoring of your Grok API usage limits:

Usage Statistics Display

When enabled (click the s button), a status bar appears at the bottom showing:

• Low Effort: remaining / total - Basic query limits
• High Effort: remaining / total - Advanced feature usage
• Grok 4 Heavy: remaining / total - Specialized model limits
• Refill: Time until limits reset (when applicable)

Visual Indicators

• Green: Normal usage levels
• Orange: Warning (≤25% remaining)
• Red: Critical (≤10% remaining)

Features

• Auto-refresh: Updates every 5 seconds when active
• Persistent settings: Remembers your display preferences
• Toggle controls: Hide/show specific statistics as needed
• Login detection: Shows "Login required" when not authenticated

Thanks to Joshua Wang for his code.

Keyboard Shortcuts

| Shortcut | Action | |----------|--------| | Ctrl+T | Open a new tab | | Ctrl+Tab | Switch to next tab | | Ctrl+Shift+Tab | Switch to previous tab | | Ctrl+R | Reload active tab | | Ctrl+I | Show information/about dialog |

Always-on-Top Feature

• Click the AOT button to toggle always-on-top mode
• The button turns green when active
• On Linux, requires wmctrl package (automatically handled)

Support & Troubleshooting

Getting Help

Need help? Found a bug? Have a feature request?

When Reporting Issues

Please include:

1. Operating System & Version: e.g., "Rocky Linux 10 with GNOME 49"
2. Application Version: Found in Help → About dialog
3. Steps to Reproduce: Detailed step-by-step instructions
4. Expected vs Actual Behavior: What should happen vs what actually happens
5. Screenshots: If applicable, especially for UI issues
6. Error Messages: Co