Update cosmic-session

Added cosmic-idle component reference link

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,30 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. Pop!_OS 24.04]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,61 @@
+blank_issues_enabled: false
+contact_links:
+  - name: cosmic-applets
+    url: https://github.com/pop-os/cosmic-applets/issues
+    about: Concern all the applets living in the dock or the panel.
+
+  - name: cosmic-comp
+    url: https://github.com/pop-os/cosmic-comp/issues
+    about: Responsible for composing your windows on the screen. If you see issues with the tilling features or your multiple displays, this is likely the place to go.
+    
+  - name: cosmic-edit
+    url: https://github.com/pop-os/cosmic-edit/issues
+    about: This is the issue tracker for COSMIC Text Editor. If you see issues with the text editor, report them here.
+    
+  - name: cosmic-files
+    url: https://github.com/pop-os/cosmic-files/issues
+    about: This is the issue tracker for COSMIC Files. If you see issues while navigating files, this is the place to go.
+    
+  - name: cosmic-settings
+    url: https://github.com/pop-os/cosmic-settings/issues
+    about: This is the issue tracker for COSMIC Settings. If you see issues while changing settings, this is the place to go.
+    
+  - name: cosmic-store
+    url: https://github.com/pop-os/cosmic-store/issues
+    about: This is the issue tracker for COSMIC Store. If you see issues with the app store, report them here.
+    
+  - name: cosmic-term
+    url: https://github.com/pop-os/cosmic-term/issues
+    about: This is the issue tracker for COSMIC Terminal. If you see issues with the terminal, report them here.
+    
+  - name: cosmic-panel
+    url: https://github.com/pop-os/cosmic-panel/issues
+    about: Contains the code to manage the dock and panel applets. You can see it as the compositor of applets. It is also responsible to draw the panel and dock at the right place (bottom, left, ect..).
+
+  - name: cosmic-screenshot
+    url: https://github.com/pop-os/cosmic-screenshot/issues
+    about: This is the tool that help you take screenshots.
+
+  - name: cosmic-workspaces-epoch
+    url: https://github.com/pop-os/cosmic-workspaces-epoch/issues
+    about: Responsible for the workspace overview. If you have an issue with workspaces, this is the place to go.
+    
+  - name: cosmic-greeter
+    url: https://github.com/pop-os/cosmic-greeter/issues
+    about: When your session is locked, or not opened yet, this is the window that will be shown. Basically the login screen.
+    
+  - name: cosmic-osd
+    url: https://github.com/pop-os/cosmic-osd/issues
+    about: Cosmic on screen display. This is for example, the audio notification when you change the volume, or the brightness one.
+    
+  - name: cosmic-applibrary
+    url: https://github.com/pop-os/cosmic-applibrary/issues
+    about: It is the application launched with super-a, that let you see what app are in your system, and launch them.
+  
+  - name: cosmic-launcher
+    url: https://github.com/pop-os/cosmic-launcher/issues
+    about: Launched with the super key. It lets you search in your application, and display the result in a list.
+    
+  - name: cosmic-bg
+    url: https://github.com/pop-os/cosmic-bg/issues
+    about: If you notice issues with the wallpaper, this is the place to go.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.gitmodules

@@ -86,3 +86,15 @@
     path = cosmic-store
     url = https://github.com/pop-os/cosmic-store.git
     branch = master
+[submodule "cosmic-wallpapers"]
+	path = cosmic-wallpapers
+	url = https://github.com/pop-os/cosmic-wallpapers.git
+	branch = master
+[submodule "cosmic-idle"]
+	path = cosmic-idle
+	url = https://github.com/pop-os/cosmic-idle.git
+	branch = master
+[submodule "cosmic-player"]
+	path = cosmic-player
+	url = https://github.com/pop-os/cosmic-player.git
+	branch = master

README.md

@@ -1,6 +1,6 @@
 # COSMIC Desktop
 
-Currently an incomplete **pre-alpha**. Testing instructions below for various distributions.
+Currently an incomplete **alpha**. Testing instructions below for various distributions.
 
 
 ## Components of COSMIC Desktop
@@ -12,10 +12,12 @@ Currently an incomplete **pre-alpha**. Testing instructions below for various di
 * [cosmic-files](https://github.com/pop-os/cosmic-files)
 * [cosmic-greeter](https://github.com/pop-os/cosmic-greeter)
 * [cosmic-icons](https://github.com/pop-os/cosmic-icons)
+* [cosmic-idle](https://github.com/pop-os/cosmic-idle)
 * [cosmic-launcher](https://github.com/pop-os/cosmic-launcher)
 * [cosmic-notifications](https://github.com/pop-os/cosmic-notifications)
 * [cosmic-osd](https://github.com/pop-os/cosmic-osd)
 * [cosmic-panel](https://github.com/pop-os/cosmic-panel)
+* [cosmic-player](https://github.com/pop-os/cosmic-player)
 * [cosmic-randr](https://github.com/pop-os/cosmic-randr)
 * [cosmic-screenshot](https://github.com/pop-os/cosmic-screenshot)
 * [cosmic-session](https://github.com/pop-os/cosmic-session)
@@ -123,24 +125,52 @@ We do our best to keep the referenced submodule commits in this repository build
 
 Notes on versioning and packaging all these components together properly will be added at a later stage once COSMIC DE gets its first release.
 
-## Installing on Pop!_OS
-COSMIC DE is near its first alpha release. Using and testing the pre-alpha is welcome. Bugs and breakage are expected.
+## Installing on Pop!\_OS
+
+COSMIC DE is in its first alpha release. Using and testing the alpha is welcome. Bugs and breakage are expected.
+
+### Pop!\_OS 24.04 Alpha
+
+The recommended way to test COSMIC Epoch on Pop!\_OS is by using the Pop!\_OS 24.04 LTS Alpha release. There are two ways to get the 24.04 Alpha:
+
+- Install it from the [latest Alpha 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 Alpha 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 Alpha, 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.
+
+### Pop!\_OS 22.04
+
+Due to dependency requirements, **COSMIC Epoch is no longer receiving updates on Pop!\_OS 22.04 LTS.** It's no longer recommended to test COSMIC Epoch on Pop!\_OS 22.04 because the latest bug fixes and features are only available on newer distributions such as Pop!\_OS 24.04.
+
+Individual COSMIC applications work in the default GNOME session of Pop!\_OS 22.04. You can install individual COSMIC applications using the following command:
+
+```
+sudo apt install cosmic-edit cosmic-files cosmic-player cosmic-store cosmic-term
+```
+
+#### Old Release on 22.04
+
+An **older release** of the COSMIC Epoch desktop environment alpha is still available on Pop!\_OS 22.04 LTS. If you encounter bugs while testing COSMIC Epoch on Pop!\_OS 22.04, please check if they exist in Pop!\_OS 24.04 before reporting them. You can install the older release on 22.04 with these instructions:
+
+##### Enable Wayland
 
-#### Enable Wayland
 `sudo nano /etc/gdm3/custom.conf`
 
-Change to true
+Change `WaylandEnable` to `true`:
+```
 WaylandEnable=true
+```
 
 Reboot for this change to take effect.
 
-#### Update udev rules for NVIDIA users
+##### Update udev rules for NVIDIA users
 
 ```shell
 sudo nano /usr/lib/udev/rules.d/61-gdm.rules
 ```
 
-Look for `LABEL="gdm_prefer_xorg"` and `LABEL="gdm_disable_wayland"`, add `#` to the `RUN` statement so it will look like this
+Look for `LABEL="gdm_prefer_xorg"` and `LABEL="gdm_disable_wayland"`. Add `#` to the `RUN` statements so they look like this:
 
 ```
 LABEL="gdm_prefer_xorg"
@@ -158,14 +188,15 @@ Restart gdm
 sudo systemctl restart gdm
 ```
 
-#### Install COSMIC
+##### Install COSMIC
+
 `sudo apt install cosmic-session`
 
 After logging out, click on your user and there will be a sprocket at the bottom right. Change the setting to COSMIC. Proceed to log in.
 
 ## Installing on Arch Linux
-Installing via the preferred AUR helper is possible the usual way, e.g.:
-`paru -S cosmic-session-git` or `yay -S cosmic-session-git`
+Install via [cosmic-session](https://archlinux.org/packages/extra/x86_64/cosmic-session/) or the [cosmic](https://archlinux.org/groups/x86_64/cosmic/) group, e.g.:
+`pacman -S cosmic-session` or `pacman -S cosmic`
 
 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 a more detailed discussion, consider the [relevant section in the Arch wiki](https://wiki.archlinux.org/title/COSMIC).
@@ -180,6 +211,28 @@ dnf install cosmic-desktop
 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/).
 
+## Installing on openSUSE tumbleweed 
+Cosmic can be installed by adding X11:COSMIC:Factory repo with opi.
+```
+opi patterns-cosmic
+```
+Select X11:COSMIC:Factory, after installing keep the repo.
+
+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 [OBS page](https://build.opensuse.org/project/show/X11:COSMIC:Factory).
+
+## 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`
+
+Next, install the COSMIC desktop environment and its associated themes:
+
+`emerge cosmic-meta pop-theme-meta`
+
+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 [Gentoo Wiki](https://wiki.gentoo.org/wiki/COSMIC) or [Overlay Repository](https://github.com/fsvm88/cosmic-overlay).
+
 ## Contact
 - [Mattermost](https://chat.pop-os.org/)
 - [Twitter](https://twitter.com/pop_os_official)

docs/DEBUGGING.md

@@ -0,0 +1,41 @@
+Debugging COSMIC
+================
+
+An assortment of useful tools and settings for debugging COSMIC.
+
+## Logs
+Cosmic-comp, cosmic-panel, and other components log to `stderr`, as well as journald (if present).
+
+## Wayland and X11 Protocols
+
+Run clients with `WAYLAND_DEBUG=1` to see what wayland calls are made. `xtrace -n <command>` can be used to see what X calls an X11 client is making.
+
+## XWayland
+
+A tool like `xprop` can be used to determine if an application is running in XWayland. If `xprop` is unable to select a window, it is a native Wayland window.
+
+## Performance
+
+`sudo perf top` can be used to see what functions, across all processes, are using the most CPU time. The `-p` argument can be used to restrict this to a single process. The output is more useful for executables with debug symbols.
+
+`cosmic-comp` integrates Tracy for profiling. It can be built with `cargo build --features profile-with-tracy --profile fastdebug`, then the Tracy client can connect from the same system or a different one
+
+## Graphics drivers
+`eglinfo` and `vulkaninfo` indicate what graphics cards and drivers are in use for hardware-accelerated rendering.
+
+On systems with NVIDIA graphics, `nvidia-smi` has information about the GPU and driver.
+
+## DRM
+The Linux DRM subsystem handles graphics cards and display controllers.
+
+`drm_info` prints information about the outputs, planes, etc. associated with each GPU and their properties. The output of this command can be useful for understanding display related issues.
+
+https://gitlab.freedesktop.org/wlroots/wlroots/-/wikis/DRM-Debugging documents how to configure DRM to enable additional logging, which can be useful for understanding some DRM driver issues.
+
+## 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.
+
+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>`.

justfile

@@ -11,10 +11,12 @@ build:
     {{ just }} cosmic-edit/build-release
     {{ just }} cosmic-files/build-release
     {{ just }} cosmic-greeter/build-release
+    {{ just }} cosmic-idle/build-release
     {{ just }} cosmic-launcher/build-release
     {{ just }} cosmic-notifications/build-release
     {{ make }} -C cosmic-osd all
     {{ 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
@@ -22,6 +24,7 @@ build:
     {{ just }} cosmic-session/all
     {{ just }} cosmic-store/build-release
     {{ just }} cosmic-term/build-release
+    {{ make }} -C cosmic-wallpapers all
     {{ make }} -C cosmic-workspaces-epoch all
     {{ make }} -C xdg-desktop-portal-cosmic all
 
@@ -34,10 +37,12 @@ install rootdir="" prefix="/usr/local": build
     {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-files/install
     {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-greeter/install
     {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-icons/install
+    {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-idle/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-panel/install
+    {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-player/install
     {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-randr/install
     {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-screenshot/install
     {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-settings/install
@@ -45,6 +50,7 @@ install rootdir="" prefix="/usr/local": build
     {{ just }} rootdir={{rootdir}} prefix={{rootdir + prefix}} cosmic-session/install
     {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-store/install
     {{ just }} rootdir={{rootdir}} prefix={{prefix}} cosmic-term/install
+    {{ make }} -C cosmic-wallpapers install DESTDIR={{rootdir}} prefix={{prefix}}
     {{ make }} -C cosmic-workspaces-epoch install DESTDIR={{rootdir}} prefix={{prefix}}
     {{ make }} -C xdg-desktop-portal-cosmic install DESTDIR={{rootdir}} prefix={{prefix}}
 
@@ -71,8 +77,10 @@ clean:
     rm -rf cosmic-edit/target
     {{ just }} cosmic-files/clean
     rm -rf cosmic-greeter/target
+    {{ just }} cosmic-idle/clean
     rm -rf cosmic-launcher/target
     rm -rf cosmic-panel/target
+    rm -rf cosmic-player/target
     rm -rf cosmic-notifications/target
     rm -rf cosmic-osd/target
     rm -rf cosmic-randr/target
@@ -82,5 +90,6 @@ clean:
     rm -rf cosmic-session/target
     {{ just }} cosmic-store/clean
     {{ just }} cosmic-term/clean
+    {{ make }} -C cosmic-wallpapers clean
     rm -rf cosmic-workspaces-epoch/target
     rm -rf xdg-desktop-portal-cosmic/target

scripts/tag.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+set -e
+
+TAG="$1"
+
+if [ -z "$TAG" ]
+then
+    echo "$0 [tag]" >&2
+    exit 1
+fi
+
+echo "Do you want to tag the current state of cosmic-epoch with the tag $TAG? (y/N)"
+read answer
+if [ "$answer" != "y" ]
+then
+    echo "Did not answer y, exiting" >&2
+    exit 1
+fi
+
+set -x
+
+git fetch --recurse-submodules
+
+git tag --force "$TAG"
+git submodule foreach git tag --force "$TAG"
+
+git push --force origin tag "$TAG"
+git submodule foreach git push --force origin tag "$TAG"