No description
Find a file
2025-10-22 04:30:57 +02: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 perf: reduce memory allocations 2025-10-22 04:30:57 +02:00
cosmic-config-derive chore: update syn to v2 2025-06-18 09:11:22 +02:00
cosmic-theme perf: reduce memory allocations 2025-10-22 04:30:57 +02:00
examples feat(wayland): corner-radius protocol support 2025-09-30 10:59:51 -04:00
i18n i18n: translation updates from weblate 2025-10-14 06:56:10 -06:00
iced@7bb364e01d Update iced for input_zone change 2025-10-17 12:06:47 -07:00
res fix(calendar): show button icons on non-Linux targets 2025-09-03 19:35:37 +02:00
src remove redundant clones, use mul_add on f32s 2025-10-22 04:30:57 +02: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 chore: update taffy crate to crates.io release 2025-09-30 22:31:43 +02:00
config.toml refactor launcher removing templates 2021-12-31 14:58:26 -05:00
i18n.toml feat: add i18n support for libcosmic widgets 2025-09-05 18:50:25 +02:00
justfile feat(widget): add table widget 2025-03-24 17:48:20 +01:00
LICENSE Initial commit 2021-11-12 20:22:30 -07:00
README.md Fix typo in README dependencies section 2025-10-02 09:00:45 -06: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 to 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