Update translations

Update for 1.0.10 tags
Update for 1.0.9 tags
2026-08-25 14:53:21 +00:00 · 2026-04-14 10:34:47 -06:00 · 2026-04-14 09:47:35 -06:00 · 2026-04-07 14:34:23 -06:00 · 2026-02-24 10:27:40 -07:00 · 2026-02-17 14:17:02 -07:00
33 changed files with 206 additions and 70 deletions
@@ -0,0 +1,8 @@
+- [ ] I have disclosed use of any AI generated code in my commit messages.
+  - If you are using an LLM, and do not fully understand the changes it is making to the code base, do not create a PR.
+  - In our experience, AI generated code often results in overly complex code that lacks enough context for a proper fix or feature inclusion. This results in considerably longer code reviews. Due to this, AI authored or partially authored PRs may be closed without comment.
+- [ ] I understand these changes in full and will be able to respond to review comments.
+- [ ] My change is accurately described in the commit message.
+- [ ] My contribution is tested and working as described.
+- [ ] I have read the [Developer Certificate of Origin](https://developercertificate.org/) and certify my contribution under its conditions.
+
@@ -17,13 +17,12 @@ jobs:
  Test:
    runs-on: ubuntu-latest
    container:
-      image: archlinux:latest
+      image: archlinux:base-devel
      volumes:
        - /:/host
    steps:
    - run: >
-        pacman --noconfirm -Syu
-        base-devel
+        pacman --noconfirm --needed -Syu
        cargo
        clang
        desktop-file-utils
@@ -31,6 +30,7 @@ jobs:
        gtk3
        gtk4
        just
+        libdisplay-info
        libinput
        libxkbcommon
        llvm
@@ -47,7 +47,7 @@ jobs:
        flatpak
        nasm
    - run: rm -rf /host/usr/local/lib/android # Free space
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v6
      with:
        submodules: recursive
    # Safe directory behavior seems to have issues with `container:`
@@ -1,6 +1,6 @@
 # COSMIC Desktop

-Currently in **beta** for Epoch 1 (the first release), which is nearly feature-complete and in the final bug fixing stage. Testing instructions for various distributions are below.
+[COSMIC](https://system76.com/cosmic) is a desktop environment offering performance, efficiency, and personalization to empower a wide variety of use cases.

 ## Components of COSMIC Desktop
 * [cosmic-applets](https://github.com/pop-os/cosmic-applets)
@@ -43,17 +43,15 @@ Currently in **beta** for Epoch 1 (the first release), which is nearly feature-c

 ## Installing on Pop!\_OS

-COSMIC DE is in its first beta release. We're in a bug fixing stage of development with features largely complete for the first release. Using and testing the beta is welcome. 
+### Pop!\_OS 24.04

-### Pop!\_OS 24.04 Beta
+COSMIC DE's first release (Epoch 1) is included in Pop!\_OS 24.04. There are two ways to get the 24.04 release:

-The recommended way to test COSMIC Epoch on Pop!\_OS is by using the Pop!\_OS 24.04 LTS Beta release. There are two ways to get the 24.04 Beta:
-
- Install it from the [latest Beta release ISO](https://system76.com/cosmic/).
+- Install it from the [latest release ISO](https://system76.com/cosmic/).
 - Upgrade an existing Pop!\_OS 22.04 installation using the following command: `pop-upgrade release upgrade -f`
    - If you experience problems during the upgrade, please open an issue in the [pop-upgrade GitHub repository](https://github.com/pop-os/upgrade) or join the [Pop!\_OS Mattermost chat server](https://chat.pop-os.org) for assistance.

-Pop!\_OS 24.04 Beta installations will be upgradable to the final 24.04 release, but some manual interventions may occasionally be required during development. If you're using Pop!\_OS 24.04 Beta, then it's recommended to join the [Pop!\_OS Mattermost chat server](https://chat.pop-os.org) to receive news about the 24.04 development cycle. Join the COSMIC Epoch channel.
+COSMIC users, including Pop!_OS users, are welcome to join the [Pop!\_OS Mattermost chat server](https://chat.pop-os.org) to receive news about development. Join the [COSMIC Epoch channel](https://chat.pop-os.org/pop-os/channels/cosmic-epoch) for COSMIC user discussion, or the [Development channel](https://chat.pop-os.org/pop-os/channels/development) for developer-oriented discussion.

 ### Pop!\_OS 22.04

@@ -118,31 +116,39 @@ Then log out, click on your user, and a sprocket at the bottom right shows an ad
 For a more detailed discussion, consider the [relevant section in the Arch wiki](https://wiki.archlinux.org/title/COSMIC).

 ## Installing on Fedora Linux
-Cosmic may be installed via a Fedora COPR repository.
+
+COSMIC can be installed from the built-in repositories on Fedora 41+:
+
 ```
-dnf copr enable ryanabx/cosmic-epoch
-dnf install cosmic-desktop
+sudo dnf install @cosmic-desktop-environment
 ```

-Then log out, click on your user, and a sprocket at the bottom right shows an additional entry alongside your desktop environments. Change to COSMIC and proceed with log in.
-For further information, you may check the [COPR page](https://copr.fedorainfracloud.org/coprs/ryanabx/cosmic-epoch/).
+Alternatively, for more up-to-date COSMIC packages (but less quality control), you can use the nightly COPR builds:
+
+```
+sudo dnf copr enable ryanabx/cosmic-epoch && sudo dnf install cosmic-desktop
+```
+
+After installing, log out, click on your user, and use the sprocket in the bottom right to select the COSMIC desktop environment before logging in.
+For more information, check the [Fedora Wiki COSMIC SIG page](https://fedoraproject.org/wiki/SIGs/COSMIC) or the [COPR page](https://copr.fedorainfracloud.org/coprs/ryanabx/cosmic-epoch/).

 ## Installing on NixOS
 The COSMIC module on NixOS can be enabled by adding the following lines to
 your NixOS configuration file (`configuration.nix` or in your Flake):
 ```nix
-  # Enable the login manager
+{
+  # Enable the COSMIC login manager
  services.displayManager.cosmic-greeter.enable = true;
-  # Enable the COSMIC DE itself
+
+  # Enable the COSMIC desktop environment
  services.desktopManager.cosmic.enable = true;
-  # Enable XWayland support in COSMIC
-  services.desktopManager.cosmic.xwayland.enable = true;
+}
 ```

 While some packages like `cosmic-session` might be present in prior versions,
 the modules that add full support for COSMIC were added in **NixOS 25.05**.

-You can find more details in the [NixOS 25.05 release notes](https://nixos.org/manual/nixos/unstable/release-notes#sec-release-25.05).
+You can find more details on the [NixOS Wiki](https://wiki.nixos.org/wiki/COSMIC).


 ## Installing on openSUSE tumbleweed
@@ -158,22 +164,31 @@ For further information, you may check the [OBS page](https://build.opensuse.org
 ## Installing on Gentoo Linux
 COSMIC can be installed on Gentoo via a custom overlay. Add the overlay using your preferred overlay manager (such as eselect), and then install the desktop environment:

-`eselect repository add cosmic-overlay git https://github.com/fsvm88/cosmic-overlay.git`
+`eselect repository add	cosmic-overlay git https://github.com/fsvm88/cosmic-overlay.git`

-Next, install the COSMIC desktop environment and its associated themes:
+Next, synchronize the repository with
+`emaint sync -r cosmic-overlay`

-`emerge cosmic-meta pop-theme-meta`
+and install the COSMIC desktop environment and its associated themes:

-Then log out, click on your user, and a sprocket at the bottom right shows an additional entry alongside your desktop environments. Change to COSMIC and proceed with log in.
+`emerge cosmic-meta pop-theme-meta -av`
+
+Please note that the ebuilds have testing keywords and need to unmasked on stable systems for successful installation.
+
+Then log out, and switch the desktop environment to COSMIC, the procedure depends on your login manager.
 For further information, you may check the [Gentoo Wiki](https://wiki.gentoo.org/wiki/COSMIC) or [Overlay Repository](https://github.com/fsvm88/cosmic-overlay).

 ## Setup on distributions without packaging of COSMIC components

-The COSMIC desktop environment requires a few dependencies:
+The COSMIC desktop environment requires a few dependencies. The rustc and just packages of your distro may be too old, so we recommend installing rustc and cargo with rustup, and installing just with cargo.
 (This list does not try to be exhaustive, but rather tries to provide a decent starting point. For detailed instructions, check out the individual projects):

 - [just](https://github.com/casey/just)
 - rustc
+- cargo
+- c compiler (cc)
+- make
+- git
 - libwayland
 - mesa (or third-party libEGL/libGL implementations, though interfacing with mesa's libglvnd is generally recommended).
 - libseat
@@ -181,16 +196,17 @@ The COSMIC desktop environment requires a few dependencies:
 - libinput
 - udev
 - dbus
+- libdisplay-info-dev
+- libgstreamer1.0-dev
+- libgstreamer-plugins-base1.0-dev

 optionally (though the build-system might currently require these libraries):
 - libsystem
 - libpulse
- pop-launcher
 - libexpat1
 - libfontconfig
 - libfreetype
 - lld
- cargo
 - libgbm-dev
 - libclang-dev
 - libpipewire-0.3-dev
@@ -199,17 +215,79 @@ Note: `libfontconfig`, `libfreetype`, and `lld` are packages specific to Linux d

 The required ones can be installed with:
 ```
-sudo apt install just rustc libglvnd-dev libwayland-dev libseat-dev libxkbcommon-dev libinput-dev udev dbus libdbus-1-dev libpam0g-dev libpixman-1-dev libssl-dev libflatpak-dev -y
+sudo apt install -y \
+  build-essential \
+  dbus \
+  git \
+  libdbus-1-dev \
+  libdisplay-info-dev \
+  libflatpak-dev \
+  libglvnd-dev \
+  libgstreamer-plugins-base1.0-dev \
+  libgstreamer1.0-dev \
+  libinput-dev \
+  libpam0g-dev \
+  libpixman-1-dev \
+  libseat-dev \
+  libssl-dev \
+  libwayland-dev \
+  libxkbcommon-dev \
+  rustup \
+  udev
+
+rustup toolchain install stable
+cargo install just
 ```

 and the optional ones with:
 ```
-sudo apt install libsystemd-dev libpulse-dev pop-launcher libexpat1-dev libfontconfig-dev libfreetype-dev mold cargo libgbm-dev libclang-dev libpipewire-0.3-dev -y
+sudo apt install -y \
+  libclang-dev \
+  libexpat1-dev \
+  libfontconfig-dev \
+  libfreetype-dev \
+  libgbm-dev \
+  libpipewire-0.3-dev \
+  libpulse-dev \
+  libsystemd-dev \
+  lld \
+  mold
 ```

 They can be installed all at once with:
 ```
-sudo apt install just rustc libglvnd-dev libwayland-dev libseat-dev libxkbcommon-dev libinput-dev udev dbus libdbus-1-dev libsystemd-dev libpixman-1-dev libssl-dev libflatpak-dev libpulse-dev pop-launcher libexpat1-dev libfontconfig-dev libfreetype-dev mold cargo libgbm-dev libclang-dev libpipewire-0.3-dev libpam0g-dev -y
+sudo apt install -y \
+  build-essential \
+  dbus \
+  git \
+  libclang-dev \
+  libdbus-1-dev \
+  libdisplay-info-dev \
+  libexpat1-dev \
+  libflatpak-dev \
+  libfontconfig-dev \
+  libfreetype-dev \
+  libgbm-dev \
+  libglvnd-dev \
+  libgstreamer-plugins-base1.0-dev \
+  libgstreamer1.0-dev \
+  libinput-dev \
+  libpam0g-dev \
+  libpipewire-0.3-dev \
+  libpixman-1-dev \
+  libpulse-dev \
+  libseat-dev \
+  libssl-dev \
+  libsystemd-dev \
+  libwayland-dev \
+  libxkbcommon-dev \
+  lld \
+  mold \
+  rustup \
+  udev
+
+rustup toolchain install stable
+cargo install just
 ```

 ### Testing
@@ -249,9 +327,12 @@ These and the `justfile` inside this repository may be used as references on how

 ### Versioning

-COSMIC DE is still a work-in-progress and thus does not follow a versioning scheme yet.
+COSMIC DE is a work in progress with many moving pieces.
 We do our best to keep the referenced submodule commits in this repository building and working together; as a consequence, they might not contain the latest updates and features from these repositories (yet).
-The commits corresponding with the current beta release are tagged `epoch-1.0.0-beta.X.Y`, where `X` is the beta release and `Y` is the minor release.
+
+The commits corresponding with the current release are tagged `epoch-X.Y.Z`, where `X` is the major release and the last two numbers denote incremental minor releases. (During development of new major versions, an additional `-alpha.Y.Z` or `-beta.Y.Z` may be appended.)
+
+COSMIC Epoch version numbers are mainly for the benefit of non-Pop!_OS distributions; Pop!_OS uses its own build system, and typically receives updates to individual submodules before they're tagged as part of a COSMIC Epoch release.

 ## Translating

@@ -34,8 +34,8 @@ https://gitlab.freedesktop.org/wlroots/wlroots/-/wikis/DRM-Debugging documents h

 ## Frozen desktop

-If the desktop is frozen and `ctrl+alt+f*` don't work to change to a TTY, [the magic SysRq key](https://www.kernel.org/doc/html/latest/admin-guide/sysrq.html) with `r` can be used to swich input in raw mode, so the kernel will handle the tty switch key binding. /etc/sysctl.conf` or `/etc/sysctl.d` may need to be edited first to set `kernel.sysrq=1` or another value that allows this command.
+If the desktop is frozen and `ctrl+alt+f*` don't work to change to a TTY, [the magic SysRq key](https://www.kernel.org/doc/html/latest/admin-guide/sysrq.html) with `r` can be used to switch input into raw mode, so the kernel will handle the tty switch key binding. `/etc/sysctl.conf` or `/etc/sysctl.d` may need to be edited first to set `kernel.sysrq=1` or another value that allows this command.

 It is also possible to connect over `ssh` from another computer.

-Then `pidof cosmic-comp` can be used to get the PID of the compositor. Then it is possible to investigate further with tools like `gdb`, using `sudo gdb` then `attach <pid>`.
+Then `pidof cosmic-comp` can be used to get the PID of the compositor. Then it is possible to investigate further with tools like `gdb`, using `sudo gdb` and then `attach <pid>`.
@@ -15,14 +15,14 @@ build:
    {{ just }} cosmic-initial-setup/build-release
    {{ just }} cosmic-launcher/build-release
    {{ just }} cosmic-notifications/build-release
-    {{ make }} -C cosmic-osd all
+    {{ just }} cosmic-osd/build-release
    {{ just }} cosmic-panel/build-release
    {{ just }} cosmic-player/build-release
    {{ just }} cosmic-randr/build-release
    {{ just }} cosmic-screenshot/build-release
    {{ just }} cosmic-settings/build-release
    {{ make }} -C cosmic-settings-daemon all
-    {{ just }} cosmic-session/all
+    {{ just }} cosmic-session/build-release
    {{ just }} cosmic-store/build-release
    {{ just }} cosmic-term/build-release
    {{ make }} -C cosmic-wallpapers all
@@ -43,7 +43,7 @@ install rootdir="" prefix="/usr/local": build
    {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-initial-setup/install
    {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-launcher/install
    {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-notifications/install
-    {{ make }} -C cosmic-osd install DESTDIR={{rootdir}} prefix={{prefix}}
+    {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-osd/install
    {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-panel/install
    {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-player/install
    {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-randr/install
@@ -2,14 +2,15 @@

 set -e

-TAG="$1"
-
-if [ -z "$TAG" ]
+if [ -z "$1" ]
 then
-    echo "$0 [tag]" >&2
+    echo "$0 [epoch version]" >&2
    exit 1
 fi

+VERSION="$1"
+TAG="epoch-$1"
+
 echo "Do you want to tag the current state of cosmic-epoch with the tag $TAG? (y/N)"
 read answer
 if [ "$answer" != "y" ]
@@ -22,8 +23,8 @@ set -x

 git fetch --recurse-submodules

-git tag --force "$TAG"
-git submodule foreach git tag --force "$TAG"
+git tag --force --annotate "$TAG" --message "Epoch ${VERSION}"
+git submodule foreach git tag --force --annotate "$TAG" --message "Epoch ${VERSION}"

 git push --force origin tag "$TAG"
 git submodule foreach git push --force origin tag "$TAG"
@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+
+set -e
+
+# This should be the _next_ epoch version
+version=1.0.9
+subject="Epoch ${version} version update"
+description="Generated by cosmic-epoch scripts/version-update.sh"
+
+repos=(
+    cosmic-edit
+    cosmic-files
+    cosmic-player
+    cosmic-store
+    cosmic-term
+)
+
+for repo in "${repos[@]}"
+do
+    git submodule update --recursive "${repo}"
+    pushd "${repo}"
+    git fetch origin
+    git checkout -B epoch-update origin/master
+    git reset --hard
+    if [ "$(dpkg-parsechangelog --show-field Version)" != "${version}" ]
+    then
+        dch --newversion "${version}" --distribution noble "${subject}"
+    fi
+    cargo set-version "${version}"
+    cargo update
+    git commit -a -m "${subject}" -m "${description}"
+    git push -f -u origin epoch-update
+    pr_url="$(gh pr list --head epoch-update --state open --json url --jq '.[].url')"
+    if [ -n "${pr_url}" ]
+    then
+        echo "PR already open: ${pr_url}"
+    else
+        gh pr create \
+            --title "${subject}" \
+            --body "${description}" \
+            --assignee "@me" \
+            --reviewer "pop-os/engineering" \
+            --reviewer "pop-os/quality-assurance"
+    fi
+    popd
+done
Author	SHA1	Message	Date
Jeremy Soller	d103b64024	Update translations	2026-04-14 10:34:47 -06:00
Jeremy Soller	9af2199729	Update for 1.0.10 tags	2026-04-14 09:47:35 -06:00
Jeremy Soller	9e8ac99bcb	Update for 1.0.9 tags	2026-04-07 14:34:23 -06:00
Jeremy Soller	efe2c51b53	Prepare for next tag	2026-02-24 10:27:40 -07:00
Jeremy Soller	9b0e61c54b	Prepare for next tag	2026-02-17 14:17:02 -07:00
Jeremy Soller	f5fa41194e	Update repos	2026-02-13 12:32:54 -07:00
Jeremy Soller	f9abdc105d	Add PR template	2026-02-13 12:21:16 -07:00
Jeremy Soller	dee71b6f25	Update for 1.0.6 tag	2026-02-10 11:07:25 -07:00
Jeremy Soller	d955da69d4	Prepare for 1.0.5 tag	2026-02-03 09:08:14 -07:00
Jeremy Soller	5dcb211692	Prepare for 1.0.4 tag	2026-01-27 14:06:37 -07:00
Jeremy Soller	e13e24b54e	Use annotated tags	2026-01-27 10:30:12 -07:00
Jeremy Soller	dafb7bb1fa	Add script to automate update of version, currently limited to apps	2026-01-21 10:16:31 -07:00
Jeremy Soller	13ea973991	Prepare for 1.0.3 tag	2026-01-20 09:08:21 -07:00
golden-spiralandGitHub	8722d5507c	docs: update Gentoo install section	2026-01-14 17:46:16 +01:00
rezsoandGitHub	e4edeeca3f	fix(just): cosmic-session uses build-release now	2026-01-14 17:45:04 +01:00
Vukašin VojinovićandMichael Murphy	7106172bcd	chore: update CI	2026-01-14 17:43:39 +01:00
Jeremy Soller	0972aa1396	Prepare for 1.0.2 tag	2026-01-13 14:40:19 -07:00
Jeremy Soller	8f98c11b8c	Prepare for 1.0.1 tag	2025-12-30 10:55:59 -07:00
Jacob KauffmannandJacob Kauffmann	da3cf5ee1e	docs: Remove additional beta messaging from README	2025-12-15 16:21:09 -07:00
killertofusandGitHub	508b7fe8e6	docs: Add new copy from website to replace beta copy	2025-12-15 17:17:00 +01:00
Jeremy Soller	39c24b0b4e	Update cosmic-launcher	2025-12-10 15:21:45 -07:00
Jeremy Soller	cb3fce4635	Minor updates before stable	2025-12-10 15:17:14 -07:00
Jeremy Soller	366bf74f49	Prepare for stable tag	2025-12-10 07:55:53 -07:00
Rerum02andJeremy Soller	3c128a6c52	Updated install instructions for nixos Had link directly to the offical wiki, and replaced instructions for installation to match the wiki	2025-12-05 08:56:28 -07:00
Brad LohmeyerandJeremy Soller	ce6bcdb54d	docs: readme: fix apt packages	2025-12-05 08:56:10 -07:00
Brad LohmeyerandJeremy Soller	87391a426f	docs: readme: reformat apt commands	2025-12-05 08:56:10 -07:00
Jeremy Soller	8cd00decac	Update for beta 9 tag	2025-12-03 08:34:58 -07:00
Rerum02 GitHub Jacob Kauffmann	221a9856f3	docs: Update README.md for Fedora (#1361 ) * Update README.md for Fedora Change cli instructions so that the user now uses the Fedora main repo. Also changed where to find more info to the Cosmic SIG page. * readd copr repo README.md * Update Fedora installation instructions --------- Co-authored-by: Jacob Kauffmann <[email protected]>	2025-11-25 14:04:02 -07:00
Jeremy Soller	ea32f6c30b	Update cosmic-osd	2025-11-25 11:49:10 -07:00
Jeremy Soller	102efba5ae	Update for beta 8 tag	2025-11-25 08:39:22 -07:00
Jeremy Soller	3ede740ebd	Update for beta 7 tag	2025-11-19 13:45:22 -07:00
Jeremy Soller	f15e88c4c6	Prepare for beta 6 tag	2025-11-12 10:50:24 -07:00
Jeremy Soller	e9a8b4be7f	Prepare for beta 5 tag	2025-11-04 15:25:53 -07:00
daweandAshley Wulber	6fb8b35cf5	Improve markdown and wording in DEBUGGING.md	2025-10-30 18:42:44 -04:00