KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

Miriway

★ 105 Open GitHub ↗

Mir based Wayland compositor

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Miriway

## Introducing Miriway
Miriway is a generic compositor using Mir that can be customised to serve the 
needs of a range of desktop environments.

Miriway has been tested with shell components from several desktop environments 
and comes with some scripts to help set up a variety of example configurations.
(See the `example-configs` directory.)

### Keyboard shortcuts using `Meta` and `Ctrl-Alt` can be added or amended

These shortcuts are the defaults provided:

These (and other) defaults are specified in `/usr/local/etc/xdg/xdg-miriway/miriway-shell.config`
and are copied for an individual user into `~/.config/miriway-shell.settings`. For more
details see [Configuring Miriway](CONFIGURING_MIRIWAY.md).

The "@" commands are internal to miriway-shell, others are commands that could be executed from a terminal.

## Miriway internals

At the core of Miriway is `miriway-shell`, a Mir based Wayland compositor that provides:
* A "floating windows" window managament policy;
* Support for Wayland (and via `Xwayland`) X11 applications;
* Dynamic workspaces;
* Additional Wayland support for "shell components" such as panels and docs; and,
* Configurable shortcuts for launching standard apps such as launcher and terminal emulator.

In addition to `miriway-shell`, Miriway has:

* A "terminal emulator finder" script `miriway-terminal`, that works with most terminal emulators;
* A launch script `miriway` to simplify starting Miriway;
* A default configuration file `miriway-shell.config`; and,
* A greeter configuration `miriway.desktop` so Miriway can be selected at login

## Pre-packaged Miriway

Miriway is available as a Snap, which provides a basic default configuration 
and also includes the example configuration scripts to help set up a variety
of options.

[![miriway](https://snapcraft.io/miriway/badge.svg)](https://snapcraft.io/miriway)

It is also available in a variety of distributions, notably Fedora.

[![Packaging status](https://repology.org/badge/vertical-allrepos/miriway.svg)](https://repology.org/project/miriway/versions)

## Building Miriway from source

Miriway can be built and installed from source (without packaging as a Snap).
The source is available from GitHub:

```plain
git clone https://github.com/Miriway/Miriway.git && cd Miriway
```

### Dependencies

Miriway uses the latest version of Mir available from the mir-team "release" PPA:

```plain
sudo apt-add-repository ppa:mir-team/release
```

Build dependencies:
```plain
sudo apt install libmiral-dev
```

Additional runtime dependencies:
```plain
sudo apt install mir-graphics-drivers-desktop
```

The default install is minimal and provides a basic shell and a default 
`Ctrl-Alt-T` command that tries to find a terminal emulator (by using 
`miriway-terminal`). If you don't already have a terminal emulator 
installed, then `sudo apt install xfce4-terminal` is a simple option.

### Building and Installing

```plain
mkdir build
cd build
cmake ..
cmake --build .
```

Installing

```plain
sudo cmake --build . -- install
```

Now you can run with `miriway`, or select "Miriway" from the login screen.

## Community

* [GitHub Discussions](https://github.com/Miriway/Miriway/discussions)
* [Matrix chat room](https://matrix.to/#/#miriway:matrix.org)

Miriway

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README