No description
Find a file
name-is-hai 18731e8392 fix(desktop): XDG desktop entry precedence
Resolve duplicate desktop IDs before applying desktop entry visibility rules

This allows user desktop entries to override matching system entries and ensures Hidden, NoDisplay, and NotShowIn overrides do not reveal lower-priority entries

Signed-off-by: name-is-hai <90458368+name-is-hai@users.noreply.github.com>
2026-07-13 16:49:31 +02:00
.github chore(progress_bar): simplify linear code 2026-06-26 17:25:28 +02:00
.vscode fix: remove rust-analyzer.linkedProjects 2024-04-13 17:11:42 -06:00
.zed chore: add rustfmt config 2026-05-04 11:55:17 -04:00
cosmic-config fix: config watcher hash & blur 2026-07-09 17:45:24 -04:00
cosmic-config-derive feat: hex_color serialization for the theme 2026-07-01 15:10:28 -04: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: no text should use the steps array for transparent color 2026-07-09 11:04:46 -04:00
examples refactor: popups for nav bar / segmented buttons 2026-07-01 15:10:28 -04:00
i18n i18n: translation updates from weblate (#1318) 2026-06-23 17:09:47 +02:00
iced@5da1188557 chore: update iced to fix corner radius 2026-07-09 18:24:36 -06:00
res feat(icon): optimize & bundle icons with crabtime for non-unix platforms 2025-11-21 18:37:49 +01:00
src fix(desktop): XDG desktop entry precedence 2026-07-13 16:49:31 +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 chore: update cosmic-protocols 2026-07-01 15:10:28 -04: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 doc: add crate level documentation 2026-05-30 19:01:01 +02:00
LICENSE Initial commit 2021-11-12 20:22:30 -07:00
README.md docs(readme): add Made for COSMIC Flatpak section 2026-05-13 16:14:34 +02:00
rustfmt.toml chore: add rustfmt config 2026-05-04 11:55:17 -04: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

Made-for-COSMIC Flatpak IDs

To identify a project as a COSMIC Application, add <id>com.system76.CosmicApplication</id> to the provides section of the project's metainfo.

<provides>
  <id>com.system76.CosmicApplication</id>
</provides>

For COSMIC Applets, use com.system76.CosmicApplet.

<provides>
  <id>com.system76.CosmicApplet</id>
</provides>

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