https://github.com/charlesrocket/topbar
An interactive bar and desktop environment
https://github.com/charlesrocket/topbar
freebsd hyprland launcher lockscreen logout-menu osd oss quickshell upower wallpaper
Last synced: about 2 months ago
JSON representation
An interactive bar and desktop environment
- Host: GitHub
- URL: https://github.com/charlesrocket/topbar
- Owner: charlesrocket
- License: afl-3.0
- Created: 2026-01-29T14:30:34.000Z (2 months ago)
- Default Branch: trunk
- Last Pushed: 2026-02-17T05:36:26.000Z (about 2 months ago)
- Last Synced: 2026-02-17T11:09:10.144Z (about 2 months ago)
- Topics: freebsd, hyprland, launcher, lockscreen, logout-menu, osd, oss, quickshell, upower, wallpaper
- Language: QML
- Homepage:
- Size: 267 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TopBar
An interactive bar and desktop environment for [Quickshell](https://quickshell.org/).
**Features**:
* responsive widgets
* app launcher
* preferences
* logout panel
* lock screen
* wallpapers
* osd
* power modes
## Requirements
1. Wayland compositor
2. Quickshell
3. Nerd fonts
## Installation
Add a submodule to the configuration repository:
```
git submodule add https://github.com/charlesrocket/topbar .config/quickshell/topbar
```
## Usage
```qml
import Quickshell
import QtQuick
import qs.topbar
ShellRoot {
TopBar {}
Wallpaper {}
}
```
Use `Settings.qml` in the Quickshell's root to override the TopBar's configuration ([example](https://github.com/charlesrocket/dotfiles/blob/3392fd9fba04580e1139b0ec84a9c63502659220/.config/quickshell/Settings.qml)).
### IPC
See `quickshell ipc call show` for all available commands.