{"id":16085065,"url":"https://github.com/pop-os/cosmic-settings","last_synced_at":"2025-04-12T01:03:21.356Z","repository":{"id":44904577,"uuid":"442204350","full_name":"pop-os/cosmic-settings","owner":"pop-os","description":"COSMIC Settings","archived":false,"fork":false,"pushed_at":"2025-04-11T14:41:23.000Z","size":3166,"stargazers_count":191,"open_issues_count":209,"forks_count":138,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-04-12T01:03:11.006Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pop-os.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-12-27T15:59:27.000Z","updated_at":"2025-04-11T14:41:27.000Z","dependencies_parsed_at":"2023-10-13T09:19:00.428Z","dependency_job_id":"6cb8871b-e971-4ef2-b322-b04dc4c90a21","html_url":"https://github.com/pop-os/cosmic-settings","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pop-os%2Fcosmic-settings","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pop-os%2Fcosmic-settings/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pop-os%2Fcosmic-settings/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pop-os%2Fcosmic-settings/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pop-os","download_url":"https://codeload.github.com/pop-os/cosmic-settings/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248501865,"owners_count":21114683,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-09T13:01:49.997Z","updated_at":"2025-04-12T01:03:21.335Z","avatar_url":"https://github.com/pop-os.png","language":"Rust","funding_links":[],"categories":["Rust","Projects Using iced"],"sub_categories":[],"readme":"# COSMIC Settings\n\nThe settings application for the [COSMIC desktop environment][cosmic-epoch].\n\n## Translators\n\nTranslation files may be found in the [i18n directory](./i18n). New translations may copy the [English (en) localization](./i18n/en) of the project and rename `en` to the desired [ISO 639-1 language code][iso-codes]. Translations may be submitted through GitHub as an issue or pull request. Submissions by email or other means are also acceptable; with the preferred name and email to associate with the changes.\n\n## Distributors\n\nThe accent palettes on the Appearance settings page are configurable through the cosmic-config directory at `/usr/share/cosmic/com.system76.CosmicSettings/v1/`. One at `accent_palette_dark`, and another at `accent_palette_light`. Examples can be found at [resources/accent_palette_dark.ron](./resources/accent_palette_dark.ron) and [resources/accent_palette_light.ron](./resources/accent_palette_light.ron). This can be copied locally to `~/.config/cosmic/com.system76.CosmicSettings/v1/` for testing, and then move to `/usr/share/cosmic` for packaging.\n\n## Build\n\n### Dependencies\n\nSee the `Build-Depends` section of the [debian control file](./debian/control).\n\n### Install\n\nCOSMIC uses [just][just] as its preferred build tool.\n\n```sh\njust\nsudo just install\n```\n\n### Packaging\n\nIf packaging for a Linux distribution, vendor dependencies locally with the `vendor` rule, and build with the vendored sources using the `build-vendored` rule. When installing files, use the `rootdir` and `prefix` variables to change installation paths.\n\n```sh\njust vendor\njust build-vendored\njust rootdir=debian/cosmic-settings prefix=/usr install\n```\n\nIt is recommended to build a source tarball with the vendored dependencies, which can typically be done by running `just vendor` on the host system before it enters the build environment. Reference [debian/rules](./debian/rules) to see how we generate debian packages with `sbuild`.\n\n## Developers\n\nDevelopers should install [rustup][rustup] and configure their editor to use [rust-analyzer][rust-analyzer]. Run `just check` to ensure that the changes you make are free of linter warnings. You may configure your editor to run `just check-json` as the rust-analyzer check command.\n\nTo improve compilation times, disable LTO in the release profile, install the [mold][mold] linker, and configure [sccache][sccache] for use with Rust. The [mold][mold] linker will only improve link times if LTO is disabled.\n\nRun the cosmic-settings binary with `just run` so that logs will be emitted to stderr, and crashes will generate detailed backtraces. Applications shouldn't crash, so when writing code, avoid use of `unwrap()` and `expect()`. Instead, log errors with `tracing::error!()` or `tracing::warn!()`.\n\n## License\n\nLicensed under the [GNU Public License 3.0](https://choosealicense.com/licenses/gpl-3.0).\n\n### Contribution\n\nAny contribution intentionally submitted for inclusion in the work by you shall be licensed under the GNU Public License 3.0 (GPL-3.0). Each source file should have a SPDX copyright notice at the top of the file:\n\n```\n// SPDX-License-Identifier: GPL-3.0-only\n```\n\n[cosmic-epoch]: https://github.com/pop-os/cosmic-epoch\n[iso-codes]: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes\n[just]: https://github.com/casey/just\n[rustup]: https://rustup.rs/\n[rust-analyzer]: https://rust-analyzer.github.io/\n[mold]: https://github.com/rui314/mold\n[sccache]: https://github.com/mozilla/sccache\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpop-os%2Fcosmic-settings","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpop-os%2Fcosmic-settings","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpop-os%2Fcosmic-settings/lists"}