Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/jmg-duarte/lospec-cli

Retrieve palettes from Lospec.com!
https://github.com/jmg-duarte/lospec-cli

Last synced: about 1 hour ago
JSON representation

Retrieve palettes from Lospec.com!

Awesome Lists containing this project

README

        

# Lospec CLI

Lospec CLI is a command-line interface tool that allows users to interact with Lospec's color palettes conveniently. With this tool, you can search for color palettes and download them.

## Usage

```
lospec
```

### Commands

- `search`: Search for color palettes
- `download`: Download a color palette
- `help`: Print this message or the help of the given subcommand(s)

### Options

- `-h, --help`: Print help

## Installation

### Cargo

To install Lospec CLI using `cargo`, run the following command:

```
cargo install lospec-cli
```

### Source

To install Lospec CLI from source, follow these steps:

1. Clone this repository:

```
git clone https://github.com/lospec/lospec-cli.git
```

2. Navigate to the project directory:

```
cd lospec-cli
```

3. Install:

```
cargo install --path .
```

## Examples

### Searching for Color Palettes

To search for color palettes, use the `search` command followed by your query:

```
lospec search --tag purple --max 8 -p 2 --sorting az
```

In other words:
* `--tag "purple"` — search for the color schemes with a "purple" tag
* `--max 8` — search for a palette with a maximum of 8 colors
* `-p 2` — show the second page of results
* `--sorting az` — sort results alphabetically

### Downloading Color Palettes

To download a color palette, use the `download` command followed by the palette's slug:

```
lospec download slso8 -f colorset
```

In other words:
* `download sls08` — download the `sls08` palette
* `-f colorset` — save the palette in XCode's `.colorset` format

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.