kali-linux-gpu-switcher

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

kali-linux-gpu-switcher

★ 10 Open GitHub ↗

A beautiful Apple-style dark UI for managing NVIDIA Optimus GPUs on Kali Linux. Made with ❤️ by Navneet Singh

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ⚡ Kali Linux GPU Switcher

A beautiful Apple-style dark UI application for managing NVIDIA Optimus GPUs on Kali Linux (and other Linux distros).

**Made with ❤️ by Navneet Singh**

![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)
![GTK](https://img.shields.io/badge/GTK-3.0-green.svg)
![License](https://img.shields.io/badge/License-MIT-yellow.svg)

## ✨ Features

- 🎨 **Apple-style Dark UI** - Beautiful matte black interface with smooth design
- 🔍 **Auto App Discovery** - Automatically indexes all installed applications
- ⚡ **GPU Mode Switching** - Switch between Intel, Hybrid, and NVIDIA modes
- 📊 **Real-time GPU Stats** - Monitor temperature, utilization, memory, and power
- 🎯 **Per-App GPU Preferences** - Set which GPU each app should use
- 🔎 **Search & Filter** - Quickly find apps with instant search
- 💾 **Persistent Config** - Your preferences are saved automatically

## 📸 Screenshot

```
╔══════════════════════════════════════════╗
║  ⚡ Kali GPU Switcher                    ║
║  Set GPU preference for your apps        ║
║                                          ║
║  ┌────────────────────────────────────┐  ║
║  │ GPU: HYBRID  [Intel][Hybrid][NVIDIA]│  ║
║  └────────────────────────────────────┘  ║
║                                          ║
║  ┌────────────────────────────────────┐  ║
║  │ 45°C · 12% · 1024 MiB · 25W        │  ║
║  └────────────────────────────────────┘  ║
║                                          ║
║  INSTALLED APPS                          ║
║  🔍 Search apps...                       ║
║                                          ║
║  ┌────────────────────────────────────┐  ║
║  │ Firefox          [NVIDIA] [N][I]   │  ║
║  │ VS Code          [DEFAULT] [N][I]  │  ║
║  │ Steam            [NVIDIA] [N][I]   │  ║
║  └────────────────────────────────────┘  ║
║                                          ║
║       Made with ❤️ by Navneet Singh      ║
╚══════════════════════════════════════════╝
```

## 🚀 Installation

### Prerequisites

```bash
# Install system dependencies
sudo apt update
sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0

# Install envycontrol for GPU switching
sudo pip3 install envycontrol
```

### Quick Install (Recommended)

```bash
# Clone the repository
git clone https://github.com/navneetsingh/kali-linux-gpu-switcher.git
cd kali-linux-gpu-switcher

# Run the installer (installs everything + creates desktop icon)
chmod +x install.sh
./install.sh
```

The installer will:
- Install all system dependencies (GTK3, PyGObject)
- Install envycontrol for GPU switching
- Copy the app to `~/.local/share/navneets-gpu-switcher/`
- Create a desktop entry with icon
- Add `gpu-switcher` command to your PATH

### Manual Run

```bash
python3 navneets-gpu-switch.py
```

## 🎮 Usage

### GPU Modes

| Mode | Description |
|------|-------------|
| **Intel** | Uses integrated Intel GPU only (best battery life) |
| **Hybrid** | Auto-switches between Intel and NVIDIA (balanced) |
| **NVIDIA** | Uses dedicated NVIDIA GPU only (best performance) |

### Per-App GPU Settings

1. Find your app in the list (use search for quick access)
2. Click **[N]** to set NVIDIA preference
3. Click **[I]** to set Intel preference
4. Click again to reset to default

### Launching Apps

Click on any app name to launch it with your configured GPU preference.

## ⚙️ Configuration

Settings are stored in `~/.config/navneet-gpu/apps.json`

```json
{
  "gpu_apps": {
    "Firefox": "nvidia",
    "Steam": "nvidia",
    "VS Code": "intel"
  }
}
```

## 🔧 Requirements

- **OS**: Kali Linux / Ubuntu / Debian / Arch (any Linux with GTK3)
- **Python**: 3.8+
- **GPU**: NVIDIA Optimus laptop
- **Packages**: 
  - `python3-gi`
  - `gir1.2-gtk-3.0`
  - `envycontrol`

## 🐛 Troubleshooting

### "GPU offline or power-saving"
This is normal when in Intel-only mode. The NVIDIA GPU is powered off to save battery.

### GPU mode not changing
Make sure `envycontrol` is installed and you have sudo privileges. A reboot is required after changing modes.

### Apps not showing
Click the refresh button (↻) to rescan installed applications.

## 📝 License

MIT License - feel free to use, modify, and distribute!

## 👨‍💻 Author

**Navneet Singh**

- Made with ❤️ for the Linux community
- Designed for Kali Linux users who need GPU control

## 🤝 Contributing

Pull requests are welcome! For major changes, please open an issue first.

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

---

⭐ **Star this repo if you find it useful!**

kali-linux-gpu-switcher

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README