https://github.com/pop-os/cosmic-launcher

WIP
https://github.com/pop-os/cosmic-launcher

Last synced: about 1 month ago
JSON representation

WIP

• Host: GitHub
• URL: https://github.com/pop-os/cosmic-launcher
• Owner: pop-os
• License: gpl-3.0
• Created: 2022-01-24T16:29:14.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-05-21T13:57:06.000Z (about 1 month ago)
• Last Synced: 2024-05-22T03:24:18.135Z (about 1 month ago)
• Language: Rust
• Size: 588 KB
• Stars: 83
• Watchers: 12
• Forks: 30
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Lists

• awesome-pop-launcher - cosmic

README

        
# Cosmic Launcher

Layer Shell frontend for https://github.com/pop-os/launcher. Currently the underlying protocol being used in the plugin for managing toplevels in wayland is defined [here](https://github.com/pop-os/cosmic-protocols/blob/main/unstable/cosmic-toplevel-info-unstable-v1.xml) but it will be switched to use [wlr-foreign-toplevel-management](https://wayland.app/protocols/wlr-foreign-toplevel-management-unstable-v1) when it is ready.

# Building

Cosmic Launcher is set up to build a deb and a Nix flake, but it can be built using just.

Some Build Dependencies:

```

  cargo,

  just,

  intltool,

  appstream-util,

  desktop-file-utils,

  libxkbcommon-dev,

  pkg-config,

  desktop-file-utils,

```

## Build Commands

For a typical install from source, use `just` followed with `sudo just install`.

```sh

just

sudo just install

```

If you are packaging, run `just vendor` outside of your build chroot, then use `just build-vendored` inside the build-chroot. Then you can specify a custom root directory and prefix.

```sh

# Outside build chroot

just clean-dist

just vendor

# Inside build chroot

just build-vendored

sudo just rootdir=debian/cosmic-launcher prefix=/usr install

```

# Translators

Translation files may be found in the i18n directory. New translations may copy the English (en) localization of the project and rename `en` to the desired [ISO 639-1 language code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes). Translations may be submitted through GitHub as an issue or pull request. Submissions by email or other means are also acceptable; with the preferred name and email to associate with the changes.

# Debugging & Profiling

## Profiling async tasks with tokio-console

To debug issues with asynchronous code, install [tokio-console](https://github.com/tokio-rs/console) and run it within a separate terminal. Then kill the **cosmic-launcher** process a couple times in quick succession to prevent **cosmic-session** from spawning it again. Then you can start **cosmic-launcher** with **tokio-console** support either by running `just tokio-console` from this repository to test code changes, or `env TOKIO_CONSOLE=1 cosmic-launcher` to enable it with the installed version of **cosmic-launcher**.