Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 1,393 Commits
.github/workflows		.github/workflows
.vscode		.vscode
cosmic-config-derive		cosmic-config-derive
cosmic-config		cosmic-config
cosmic-theme		cosmic-theme
examples		examples
iced @ 07f6669		iced @ 07f6669
res		res
src		src
.gitignore		.gitignore
.gitmodules		.gitmodules
Cargo.toml		Cargo.toml
LICENSE		LICENSE
README.md		README.md
config.toml		config.toml
justfile		justfile

Repository files navigation

LIBCOSMIC

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

Documentation

API Documentation: Automatically generated from this repository viacargo doc
libcosmic Book: A reference for learning libcosmic

Templates

https://github.com/pop-os/cosmic-app-template: Application project template

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 theexamples directory to to kickstart yourCOSMIC adventure. To run them, you need to clone the repository with the following commands:

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

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

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

The examples may then be run by their cargo project names, such asjust 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 withtokio
tokio: Uses tokio as the preferred async runtime.
- If unset, the default executor defined by iced will be used.
- Conflicts withsmol
wayland: Wayland-compatible client windows.
- Conflicts withwinit
winit: Cross-platform and X11 client window support
- Conflicts withwayland
wgpu: GPU accelerated rendering with WGPU.
- By default, softbuffer is used for software rendering.
xdg-portal: Enables XDG portal dialog integrations.