Cortex

A modern system configuration tool for Linux, built with GTK4 and Python (libadwaita). Cortex brings together system tweaks, privacy controls, and Tor/network management in one clean interface.

Screenshot

Features

• Tweaks - Appearance, fonts, window behavior, startup apps, GNOME extensions, lid actions
• Privacy - Screen & lock settings, recent files control, diagnostics opt-out
• Tor & Network - Tor service control, proxy settings, DNS leak detection, torrc editor

Requirements

• Python 3
• GTK 4 (gir1.2-gtk-4.0)
• libadwaita (gir1.2-adw-1)
• Tor (tor)
• python3-gi, python3-gi-cairo
• Optional: python3-stem for Tor circuit info

Installation

git clone https://github.com/intelseclab/cortex
cd cortex
sudo bash install.sh

The installer handles all dependencies automatically on Ubuntu/Debian/Kali.

Running

# After install
cortex

# Or directly from source
python3 run.py

Project Structure

cortex/
├── cortex/
│   ├── main.py        # App entry point
│   ├── window.py      # Main window & navigation
│   └── pages/
│       ├── tweaks.py  # System tweak pages
│       ├── privacy.py # Privacy pages
│       └── tor.py     # Tor & network pages
├── data/
│   ├── icons/         # App icons (16–512px + SVG)
│   └── cortex.desktop # Desktop entry
├── install.sh         # System installer
└── run.py             # Launcher

Contributing

Contributions are welcome. To get started:

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

Please open an issue first for major changes to discuss what you'd like to add. Bug reports and feature requests are also appreciated via the issue tracker.

Credits

• Icon: brain-circuit from Lucide Icons (ISC license)
• Built with ❤️ by Atilla

License

© 2026 IntelSecLab community