Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/haru52/convertflac

Convert FLAC audio files into ALAC or MP3 files.
https://github.com/haru52/convertflac

alac audio cli converter encoder flac mp3 pip python

Last synced: 18 days ago
JSON representation

Convert FLAC audio files into ALAC or MP3 files.

Awesome Lists containing this project

README

        

# convertflac: Convert FLAC CLI

[![Test](https://github.com/haru52/convertflac/actions/workflows/test.yml/badge.svg)](https://github.com/haru52/convertflac/actions/workflows/test.yml)
[![Release](https://github.com/haru52/convertflac/actions/workflows/release.yml/badge.svg)](https://github.com/haru52/convertflac/actions/workflows/release.yml)
[![CodeQL](https://github.com/haru52/convertflac/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/haru52/convertflac/actions/workflows/github-code-scanning/codeql)
[![Copy/Paste](https://github.com/haru52/convertflac/blob/main/report/jscpd-badge.svg)](https://github.com/haru52/convertflac/blob/main/report/jscpd-report.md)
[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](https://haru52.github.io/convertflac/CODE_OF_CONDUCT.html)
[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](https://commitizen.github.io/cz-cli/)
[![semantic-release: conventionalcommits](https://img.shields.io/badge/semantic--release-conventionalcommits-e10079?logo=semantic-release)](https://github.com/semantic-release/semantic-release)

## Overview

convertflac converts FLAC audio files into ALAC or MP3 files.

## Requirements

| Tool | Version |
| ------ | ------- |
| FFmpeg | ^5.1.2 |

## Installation

```sh
pip install convertflac
```

## Usage

```console
Usage: convertflac [OPTIONS] INPUT_DIRECTORY_PATH
[OUTPUT_DIRECTORY_PATH]

Convert FLAC audio files into Apple Lossless Audio Codec (ALAC) or
MP3 320kbps CBR files.

Options:
-c, --codec TEXT Set the output codec (alac or mp3. Default: alac).
--version Show the version and exit.
-h, --help Show this message and exit.
```

If you don't input `[OUTPUT_DIRECTORY_PATH]`, convertflac makes `alac` or `mp3` directory in the current directory and sets this `alac/` or `mp3/` as the output directory.

## Update

```sh
pip install -U convertflac
```

## Uninstall

```sh
pip uninstall convertflac
```

## Description

- convertflac converts FLAC audio files into Apple Lossless Audio Codec (ALAC) or MP3 320kbps CBR files
- The output preserves the input directory structure
- The output ALAC/MP3 files preserve the input FLAC files' metadata
- If an ALAC/MP3 file with the same name already exists at the output directory, convertflac doesn't overwrite it

## Versioning policy

[Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.0.html)

## License

[MIT](https://github.com/haru52/convertflac/blob/main/LICENSE)

## Contributing

[Contributing Guideline](https://haru52.github.io/convertflac/CONTRIBUTING.html)

## Documentation

[Documentation | convertflac](https://haru52.github.io/convertflac/)

## Author

[haru](https://haru52.com/)