No description
Find a file
2026-05-25 11:37:02 +02:00
.github fix(ci): cargo now running properly 2026-04-08 07:34:13 +02:00
.vscode fix: remove rust-analyzer.linkedProjects 2024-04-13 17:11:42 -06:00
cosmic-config yoda: use local dbus settings bindings 2026-05-25 09:55:11 +02:00
cosmic-config-derive chore: update dependencies 2026-01-27 18:07:35 -07:00
cosmic-icons@5252095787 feat(cosmic-icons): new icons for cosmic image viewer app 2026-03-03 23:32:00 +01:00
cosmic-theme yoda: cosmic-theme cleanup (4→0 warnings) — workspace at 0 warnings total 2026-05-05 19:07:35 +02:00
examples yoda: re-apply hard rename — libcosmic → libcosmic-yoda (0.1.0-yoda) 2026-04-23 15:32:29 +02:00
i18n yoda: re-apply hard rename — libcosmic → libcosmic-yoda (0.1.0-yoda) 2026-04-23 15:32:29 +02:00
iced@8163993539 chore: update iced submodule pointer 2026-05-25 11:37:02 +02:00
res feat(icon): optimize & bundle icons with crabtime for non-unix platforms 2025-11-21 18:37:49 +01:00
src fix: gate reorderable flex row shadow constant 2026-05-24 10:01:43 +02:00
.gitignore chore: remove debian directory 2023-09-15 17:37:35 +02:00
.gitmodules feat(icon): optimize & bundle icons with crabtime for non-unix platforms 2025-11-21 18:37:49 +01:00
build.rs widget/icon: Bundle icons on macOS, not just Windows 2026-04-14 21:46:05 +02:00
Cargo.toml yoda: use local dbus settings bindings 2026-05-25 09:55:11 +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 docs: add link to cosmic-applet-template 2025-12-17 03:25:00 +01: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