Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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 (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-10-29T16:26:31.000Z (about 1 month ago)
- Last Synced: 2024-10-31T17:38:44.936Z (about 1 month ago)
- Language: Rust
- Size: 752 KB
- Stars: 105
- Watchers: 16
- Forks: 54
- Open Issues: 51
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-iced - cosmic-launcher - Frontend for [Pop Launcher](https://github.com/pop-os/launcher), a modular IPC-based dekstop launcher service. (Projects Using iced)
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**.