> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clickwheel.fm/llms.txt
> Use this file to discover all available pages before exploring further.

# Library

> clickwheel Library commands and their options.

## `convert`

```bash theme={null}
clickwheel convert [OPTIONS]
```

Convert FLAC albums to iPod-playable MP3.

<ParamField path="--artist, -a" type="string">
  Convert FLAC for this artist
</ParamField>

<ParamField path="--album" type="string">
  Restrict to this album (use with --artist)
</ParamField>

<ParamField path="--all-flac" type="boolean">
  Convert every FLAC album in the library
</ParamField>

<ParamField path="--bitrate" type="integer">
  MP3 CBR kbps (default: config transcode\_bitrate)
</ParamField>

<ParamField path="--force" type="boolean">
  Re-convert even if already converted
</ParamField>

<ParamField path="--no-scan" type="boolean">
  Skip automatic library scan
</ParamField>

## `fix`

```bash theme={null}
clickwheel fix [OPTIONS] [ARTIST]
```

Fill in missing album art, genres, and other track details.

**Examples**

```bash theme={null}
# Repair the whole library: album art, year, genres
clickwheel fix

# Just one artist folder
clickwheel fix "Nirvana"

# Re-fetch genres, ignoring the cache
clickwheel fix --refresh-genres
```

<ParamField path="--dry-run" type="boolean">
  Show what would be done without making changes
</ParamField>

<ParamField path="--refresh-mb" type="boolean">
  Re-query MusicBrainz, ignoring the cache. Use after a known-bad cached match.
</ParamField>

<ParamField path="--refresh-genres" type="boolean">
  Re-query Last.fm for genres, ignoring the cache.
</ParamField>

<ParamField path="artist" type="string">
  Artist folder name to target (default: entire library)
</ParamField>

## `scan`

```bash theme={null}
clickwheel scan [OPTIONS]
```

Scan your music library and check for missing info.

**Examples**

```bash theme={null}
# Incremental index of new or changed files
clickwheel scan

# Rescan the whole library from scratch
clickwheel scan --full
```

<ParamField path="--full, -f" type="boolean">
  Rescan everything from scratch
</ParamField>

<ParamField path="--stats" type="boolean">
  Show library stats without scanning again
</ParamField>