Project

CatFlac

0.0
The project is in a healthy, maintained state
CatFlac is an utility that helps you split large lossless audio files into tracks using CUE sheets or experimental AI identification. Still in early development.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Runtime

 Project Readme

🧶 CatFlac

CatFlac Mascot

CatFlac is a simple tool for splitting large audio files. It's currently in its initial stage - functional, but probably needs some improvements.


Current Skills

  • CUE Support: Handles basic external and embedded CUE sheets.
  • Experimental AI: A curious attempt at track identification (requires AI_API_KEY).

🐾 Getting Started

First of all you need to install ffmpeg on your system.

sudo apt install ffmpeg

Then install the gem:

gem install CatFlac

Or add this to your application's Gemfile:

gem 'CatFlac'

Then run:

bundle install

And if you use rbenv:

rbenv rehash

Usage

Using CatFlac is pretty straightforward.

Command Line Interface

Just point CatFlac to a folder containing your audio files:

catflac cat /path/to/your/music_folder

Ruby API

Integrating CatFlac into your project:

require 'CatFlac'

CatFlac.cat!('/path/to/your/music_folder')

Experimental AI Mode

If you don't have a CUE sheet, you can try letting CatFlac guess the tracks. To do so, set perplexity api key as an environment variable:

export AI_API_KEY='api_key_here'

catflac cat /path/to/mysterious_album

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/lxndr128/CatFlac

License

This gem is available as open source under the terms of the MIT License.