Change the look and feel of QGIS with custom Qt stylesheets.
- Apply any
.qssstylesheet to QGIS - Live preview when selecting themes
- Add your own custom styles
- Auto-reload when editing
.qssfiles (great for theme development) - Auto-discover themes from
examples/folder - Persists your last active style across sessions
Drop a folder with a .qss file inside examples/ and it will appear automatically in the plugin:
examples/
└── My Theme/
├── my_theme.qss
└── icons/ (optional)
└── icon.png
- Open QGIS
- Go to Plugins > Manage and Install Plugins
- Search for Load QSS
- Click Install Plugin
- Download the latest
.zipfrom Releases - In QGIS: Plugins > Manage and Install Plugins > Install from ZIP
- Select the downloaded file
./install_dev.sh
Creates a symlink in the QGIS plugins directory. Use Plugin Reloader for live reload.
# Validate project python3 build.py # Create optimized plugin zip python3 deploy/plugin_zip.py
The deploy script:
- Excludes dev files (
.git,build.py,*.sh, etc.) - Quantizes PNG images (saves ~200 KB)
- Strips Python comments and docstrings
Push a tag to create a GitHub Release with the plugin zip:
git tag v1.5.0 git push origin v1.5.0
LoadQSS/
├── __init__.py # Plugin entry point (classFactory)
├── loadQSS.py # Main plugin class (auto-discovers themes)
├── loadQSSDialog.py # Theme selector dialog
├── aboutQSSDialog.py # About dialog
├── metadata.txt # QGIS plugin metadata
├── utils/
│ ├── __init__.py
│ └── utils.py # Style management (QgsSettings)
├── ui/
│ ├── loadQSSDialog.ui # Main dialog UI
│ └── aboutQSSDialog.ui # About dialog UI
├── images/ # Plugin icons (icon.png, info.png, samples)
├── examples/ # QSS themes
├── deploy/
│ └── plugin_zip.py # Release zip builder (PNG optimize, strip comments)
├── build.py # Build validation (metadata, structure, syntax)
├── install_dev.sh # Dev symlink installer
├── setup_qgis_dev.sh # Full dev setup
├── uninstall_dev.sh # Remove dev install
└── .github/workflows/
├── ci.yml # CI pipeline
└── plugin-deploy.yml # Release automation
GPL v3 - See LICENSE
If this project has been useful to you, you can support its development by making a donation.
Francisco Raga (All4Gis) - franka1986@gmail.com