Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/christopher-l/space-bar
GNOME Shell extension that shows workspaces buttons in top panel
https://github.com/christopher-l/space-bar
Last synced: about 2 months ago
JSON representation
GNOME Shell extension that shows workspaces buttons in top panel
- Host: GitHub
- URL: https://github.com/christopher-l/space-bar
- Owner: christopher-l
- Fork: true (fthx/workspaces-bar)
- Created: 2022-04-03T14:02:36.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-06T18:29:22.000Z (8 months ago)
- Last Synced: 2024-04-06T19:28:27.160Z (8 months ago)
- Language: TypeScript
- Size: 648 KB
- Stars: 141
- Watchers: 5
- Forks: 10
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
- stars - christopher-l/space-bar
README
# Space Bar
GNOME Shell extension that replaces the top-panel workspace indicator with an i3-like workspaces bar.
On GNOME Extensions: https://extensions.gnome.org/extension/5090/space-bar/
Originally a fork of the extension [Workspaces
Bar](https://extensions.gnome.org/extension/3851/workspaces-bar/) by
[fthx](https://extensions.gnome.org/accounts/profile/fthx), this extension grew into a more
comprehensive set of features to support a workspace-based workflow.
## Features
- First class support for static and dynamic workspaces as well as multi-monitor setups
- Add, remove, and rename workspaces
- Rearrange workspaces via drag and drop
- Automatically assign workspace names based on started applications
- Keyboard shortcuts extend and refine system shortcuts
- Scroll through workspaces by mouse wheel over the panel
- Customize the appearance
## Build
The source code of this extension is written in TypeScript. The following command will build the
extension and package it to a zip file.
```sh
./scripts/build.sh
```
## Install
The following command will build the extension and install it locally.
```sh
./scripts/build.sh -i
```
## Generate types
For development with TypeScript, you can get type support in IDEs like VSCode by building and
installing type information for used libraries. Generating types is optional and not required for
building the extension. (For that, we use a different configuration that stubs type information with
dummy types.)
To generate types, run
```sh
npm install
npm run build:types
```
Choose "All" and "Yes" for everything.
## Debug
Run a GNOME shell instance in a window:
```sh
dbus-run-session -- gnome-shell --nested --wayland
```
View logs:
```sh
journalctl -f -o cat /usr/bin/gnome-shell
```
View logs of settings:
```sh
journalctl -f -o cat /usr/bin/gjs
```
Configuration:
```sh
GSETTINGS_SCHEMA_DIR=::$HOME/.local/share/gnome-shell/extensions/space-bar@luchrioh/schemas dconf-editor /org/gnome/shell/extensions/space-bar/ &>/dev/null
```