Centerpiece

A blazing fast, extendable launcher for wayland.

centerpiece is designed with these values in mind:

⚡ blazing fast performance
⚫ minimalistic UI
🔌 extendable through plugins

Demo

Run it!

Centerpiece is not packed in any major package manager yet. However you can easily run it through nix.

Try it using nix run

nix run github:friedow/centerpiece

Use it with home-manager

Add this repository to your flake.nix inputs

{
    inputs.centerpiece.url = "github:friedow/centerpiece";
}

Register the home-manager module and enable centerpiece

{ inputs, ... }: {
    home-manager.users.<USER> = {
        imports = [ inputs.centerpiece.hmModules."x86_64-linux".default ];

        programs.centerpiece.enable = true;
    };
}

See the 'Configure' section for more nix config options.

Plugins

All plugins are enabled by default. Disable the ones you don't need ;).

Sway Window Switcher

Search for open sway windows and switch between them.

Related config keys

# ~/.config/centerpiece/config.yml
plugin:
  sway_windows:
    enable: true

Application Launcher

Search for installed applications and launch them.

This plugin searches for .desktop files. It follows the XDG Base Directory Specification. Thus, it searches in directories specified in the XDG_DATA_DIRS and XDG_DATA_HOME environment variables.

Related config keys

# ~/.config/centerpiece/config.yml
plugin:
  applications:
    enable: true

Browser Integration

Open bookmarks and browser history in new tabs.

Brave

In addition to bookmarks and history there is also a plugin to open special bookmarks in app mode. This will launch a brave instance without address and tab bar. To use this plugin put bookmarks into a Bookmark folder called 'Progressive Web Apps' at the top of your bookmarks collection.

Related config keys

# ~/.config/centerpiece/config.yml
plugin:
  brave_bookmarks:
    enable: true
  brave_history:
    enable: true
  brave_progressive_web_apps:
    enable: true

Firefox

Related config keys

# ~/.config/centerpiece/config.yml
plugin:
  firefox_bookmarks:
    enable: true
  firefox_history:
    enable: true

Git Repositories

List git repositories in your home directory and open a terminal and an editor in them.

Selecting a git repository will execute the configured commands. Defaults to opening a terminal and a code editor in the selected directory.

Searching for git repositories in the whole home directory is resource heavy. To avoid delays in the plugin launch time this plugin comes with a systemd service which will create an index file. This index file is located at ~/.cache/centerpiece/git-repositories-index.json and necessary for the plugin to work.

It exports the following environment variables:

$GIT_DIRECTORY: The path to the git directory.
$GIT_DIRECTORY_NAME: The name of the git directory.

If zoxide integration is enabled, the plugin will sort your projects based on their respective zoxide scores.

Related config keys

# ~/.config/centerpiece/config.yml
plugin:
  git_repositories:
    enable: true
    zoxide: true
    commands:
      - ["alacritty", "--command", "nvim", "$GIT_DIRECTORY"]
      - ["alacritty", "--working-directory", "$GIT_DIRECTORY" "--class" "$GIT_DIRECTORY_NAME"]

Gitmoji

List gitmojis and copy them.

Note: You need to have wl-clipboard installed on your system.

Related config keys

# ~/.config/centerpiece/config.yml
plugin:
  gitmoji:
    enable: false

System Commands

Lock, sleep, restart or shutdown your system.

The following commands are executed when the respective actions are selected.

lock: lock
sleep: systemctl suspend
restart: reboot
shutdown: poweroff

Related config keys

# ~/.config/centerpiece/config.yml
plugin:
  system:
    enable: true

WiFi

List nearby wifi networks and connect to them.

Related config keys

# ~/.config/centerpiece/config.yml
plugin:
  wifi:
    enable: true

Resource Monitor

Display current cpu, ram, disk usage and battery state.

Related config keys

# ~/.config/centerpiece/config.yml
plugin
  resource_monitor_battery:
    enable: true
  resource_monitor_cpu:
    enable: true
  resource_monitor_disks:
    enable: true
  resource_monitor_memory:
    enable: true

Clock

Display current date and time.

Related config keys

# ~/.config/centerpiece/config.yml
plugin:
  clock:
    enable: true

Configure

You can configure centerpiece through yaml or nix.

You can specify alternative configuration locations through:

the --config flag
the CENTERPIECE_CONFIGURATION_FILE environment variable

Using yml

Create a config.yml file in ~/.config/centerpiece/config.yml.

Use the following config keys to configure centerpiece. These are all config keys including their respective defaults.

plugin:
  applications:
    enable: true
  brave_bookmarks:
    enable: true
  brave_history:
    enable: true
  brave_progressive_web_apps:
    enable: true
  clock:
    enable: true
  firefox_bookmarks:
    enable: true
  firefox_history:
    enable: true
  git_repositories:
    enable: true
    commands:
      - ["alacritty", "--command", "nvim", "$GIT_DIRECTORY"]
      - ["alacritty", "--working-directory", "$GIT_DIRECTORY"]
  gitmoji:
    enable: false
  resource_monitor_battery:
    enable: true
  resource_monitor_cpu:
    enable: true
  resource_monitor_disks:
    enable: true
  resource_monitor_memory:
    enable: true
  system:
    enable: true
  wifi:
    enable: true
  sway_windows:
    enable: true

Using nix

Install the home-manager module as documented in the 'Run it!' section.

Use the following config keys to configure centerpiece. These are all config keys including their respective defaults.

{ inputs, ... }: {
    home-manager.users.<USER> = {
        imports = [ inputs.centerpiece.hmModules."x86_64-linux".default ];

        programs.centerpiece = {
            enable = true;
            config = {
                plugin = {
                    applications = {
                        enable = true;
                    };
                    brave_bookmarks = {
                        enable = true;
                    };
                    brave_history = {
                        enable = true;
                    };
                    brave_progressive_web_apps = {
                        enable = true;
                    };
                    clock = {
                        enable = true;
                    };
                    firefox_bookmarks = {
                        enable = true;
                    };
                    firefox_history = {
                        enable = true;
                    };
                    git_repositories = {
                        enable = true;
                        commands = [
                            ["alacritty" "--command" "nvim" "$GIT_DIRECTORY"]
                            ["alacritty" "--working-directory" "$GIT_DIRECTORY"]
                        ];
                    };
                    gitmoji = {
                        enable = false;
                    };
                    resource_monitor_battery = {
                        enable = true;
                    };
                    resource_monitor_cpu = {
                        enable = true;
                    };
                    resource_monitor_disks = {
                        enable = true;
                    };
                    resource_monitor_memory = {
                        enable = true;
                    };
                    system = {
                        enable = true;
                    };
                    wifi = {
                        enable = true;
                    };
                    sway_windows = {
                        enable = true;
                    };
                };
            };

            # enables a systemd service to index git-repositories
            services.index-git-repositories = {
                 enable = true;
                 interval = "5min";
             };
        };
    };
}

Contribute

Repository Structure

/client

Contains the graphical application and the plugin code that is needed during runtime. This is most of the plugin code which handles requests for searching and opening of entries.

/services

Computations for generating plugin entries can be time consuming. For example listing all git repositories entails searching your whole home directory for directories with the name .git. To avoid slowing down the graphical application during run time this directory contains code for small systemd services that write indices for plugins with time consuming queries.

Development Setup

Build Environment

The flake.nix provides a ready-to-roll build environment usable with nix develop.

Building the Application

Run a new bash shell containing the build environment
```
nix develop
```
Run the application
```
cargo run
```

Name		Name	Last commit message	Last commit date
Latest commit History 335 Commits
.github		.github
client		client
screenshots		screenshots
services/index-git-repositories		services/index-git-repositories
.envrc		.envrc
.gitignore		.gitignore
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
README.md		README.md
flake.lock		flake.lock
flake.nix		flake.nix
formatter.nix		formatter.nix
home-manager-module.nix		home-manager-module.nix

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Centerpiece

Demo

Run it!

Plugins

Sway Window Switcher

Application Launcher

Browser Integration

Brave

Firefox

Git Repositories

Gitmoji

System Commands

WiFi

Resource Monitor

Clock

Configure

Using yml

Using nix

Contribute

Repository Structure

/client

/services

Development Setup

Build Environment

Building the Application

About

Releases

Packages

Languages

pinpox/centerpiece

Folders and files

Latest commit

History

Repository files navigation

Centerpiece

Demo

Run it!

Plugins

Sway Window Switcher

Application Launcher

Browser Integration

Brave

Firefox

Git Repositories

Gitmoji

System Commands

WiFi

Resource Monitor

Clock

Configure

Using yml

Using nix

Contribute

Repository Structure

/client

/services

Development Setup

Build Environment

Building the Application

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages