1 stable release

new 1.0.0 Dec 16, 2024

#543 in Command line utilities

Download history 131/week @ 2024-12-11

131 downloads per month

GPL-3.0-only

60KB
1.5K SLoC

cosmic-ctl

CLI for COSMIC Desktop configuration management.

Overview

cosmic-ctl (short for COSMIC configuration utilities) is a command-line interface for managing the configuration of the COSMIC Desktop. It allows users to read, write, delete, and backup configuration entries for various components.

Features

  • Write: Add or update a configuration.
  • Read: Retrieve a configuration value.
  • Delete: Remove a configuration.
  • Apply: Write configurations from a JSON file.
  • Backup: Backup all configuration entries to a JSON file.

Installation

Build from source

You can build this project using Cargo:

cargo build --release

Usage

Commands

  • Write
cosmic-ctl write --component <component> --entry <entry> --version <version> <value>
  • Read
cosmic-ctl read --component <component> --entry <entry> --version <version>
  • Delete
cosmic-ctl delete --component <component> --entry <entry> --version <version>
  • Apply
cosmic-ctl apply /path/to/json/file
  • Backup
cosmic-ctl backup /path/to/output/json/file

LICENSE

This project is licensed under the GPL-3.0-only license. See the LICENSE for details.

Dependencies

~1.8–9MB
~86K SLoC