No description
Find a file
Ashley Wulber 4b92ee5f80 chore: update iced
includes fix for virtual offsets
2026-03-09 17:05:27 -04:00
.github chore: update deps and test fixes 2026-03-04 12:04:33 -05:00
.vscode fix: remove rust-analyzer.linkedProjects 2024-04-13 17:11:42 -06:00
cosmic-config wip rebase updates 2026-03-04 12:04:32 -05: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 fix(cosmic-theme): on reset of theme exports, do not remove VS code configs 2026-03-03 21:18:45 +01:00
examples fix(iced): reversed scroll direction 2026-03-06 17:55:53 +01:00
i18n i18n: translation updates from weblate 2026-03-08 09:09:56 +00:00
iced@99bc455118 chore: update iced 2026-03-09 17:05:27 -04:00
res feat(icon): optimize & bundle icons with crabtime for non-unix platforms 2025-11-21 18:37:49 +01:00
src fix(dnd_source): rely on current cursor position for hover state 2026-03-06 20:37:56 +01: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 build(windows): change icon path separator for native windows builds 2025-12-09 20:01:57 +01:00
Cargo.toml chore: update deps and test fixes 2026-03-04 12:04:33 -05: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