Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cosmic-utils/cosmic-ctl

CLI for COSMIC Desktop configuration management
https://github.com/cosmic-utils/cosmic-ctl

cli command-line configuration cosmic cosmic-desktop linux pop-os rust settings tool

Last synced: 9 days ago
JSON representation

CLI for COSMIC Desktop configuration management

Awesome Lists containing this project

README

        

# 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:

```bash
cargo build --release
```

## Usage

### Commands

- Write

```bash
cosmic-ctl write --component --entry --version
```

- Read

```bash
cosmic-ctl read --component --entry --version
```

- Delete

```bash
cosmic-ctl delete --component --entry --version
```

- Apply

```bash
cosmic-ctl apply /path/to/json/file
```

- Backup

```bash
cosmic-ctl backup /path/to/output/json/file
```

# LICENSE

This project is licensed under the `GPL-3.0-only` license. See the [LICENSE](LICENSE) for details.