No description
Find a file
2025-03-14 16:56:21 +01:00
.github/workflows chore: fix examples and add them to GitHub CI 2024-09-03 13:33:26 +02:00
.vscode fix: remove rust-analyzer.linkedProjects 2024-04-13 17:11:42 -06:00
cosmic-config fix: include config id in subscription id 2025-03-09 06:05:01 +01:00
cosmic-config-derive fix(cosmic-config-derive): do not return error when getting config which is not set 2024-03-07 07:13:40 -07:00
cosmic-theme feat: high contrast theme updates 2025-03-10 16:10:32 +01:00
examples feat: Tooltips and Better Surface Management 2025-03-14 16:56:21 +01:00
iced@0788075435 feat: Tooltips and Better Surface Management 2025-03-14 16:56:21 +01:00
res improv: switch to Open Sans and Noto Sans Mono, with tweaked text styles 2025-02-18 23:57:58 +01:00
src feat: Tooltips and Better Surface Management 2025-03-14 16:56:21 +01:00
.gitignore chore: remove debian directory 2023-09-15 17:37:35 +02:00
.gitmodules chore: remove deprecated design-demo example 2024-09-13 01:07:34 +02:00
Cargo.toml feat: Tooltips and Better Surface Management 2025-03-14 16:56:21 +01:00
config.toml refactor launcher removing templates 2021-12-31 14:58:26 -05:00
justfile chore: remove design demo example 2024-05-29 06:25:15 -06:00
LICENSE Initial commit 2021-11-12 20:22:30 -07:00
README.md fixup README 2025-03-05 10:04:18 -07:00

LIBCOSMIC

A platform toolkit based on iced for creating applets and applications for the COSMIC™ desktop.

Documentation

Templates

Dependencies

While libcosmic is written entirely in Rust, some of its dependencies may require shared system library headers to be installed. On Pop!_OS, the following dependencies are all that's necessary compile a typical COSMIC project:

sudo apt install cargo cmake just libexpat1-dev libfontconfig-dev libfreetype-dev libxkbcommon-dev pkgconf

Examples

Some examples are included in the examples directory to to kickstart your COSMIC adventure. To run them, you need to clone the repository with the following commands:

git clone --recurse-submodules https://github.com/pop-os/libcosmic
cd libcosmic

If you have already cloned the repository, run these to sync with the latest updates:

git fetch origin
git checkout master
git reset --hard origin/master

The examples may then be run by their cargo project names, such as just run application.

Cargo Features

Available cargo features to choose from:

  • a11y: Experimental accessibility support.
  • animated-image: Enables animated images from the image crate.
  • debug: Enables addtional debugging features.
  • smol: Uses smol as the preferred async runtime.
    • Conflicts with tokio
  • tokio: Uses tokio as the preferred async runtime.
    • If unset, the default executor defined by iced will be used.
    • Conflicts with smol
  • wayland: Wayland-compatible client windows.
    • Conflicts with winit
  • winit: Cross-platform and X11 client window support
    • Conflicts with wayland
  • wgpu: GPU accelerated rendering with WGPU.
    • By default, softbuffer is used for software rendering.
  • xdg-portal: Enables XDG portal dialog integrations.

Project Showcase

Licence

Licensed under the Mozilla Public License 2.0.

Contact