ffrs 0.1.0

# ffrs - Media Conversion CLI Tool

ffrs is a CLI tool that translates plain English commands into ffmpeg commands. It provides both a library API and a command-line interface for media conversion tasks.

## The Story

I’m a simple guy.

I watch a YouTube livestream about vibe coding.
That curiosity pulls me into a search. I look up **spec-kit**—and there it is. Found.

Then I drift.
I scroll my Facebook timeline.
Scroll.
Scroll again.
Refresh.

Suddenly, nixCraft posts about the **ffrs CLI tool**.
Yeah, it’s written in JavaScript—and the comment section is exactly what you’d expect.

Then someone drops the line that changes everything:

> “This is my only complaint. It’s a great idea—just rewrite it in Rust or Go and ship it as a single binary.”

Me?
**Why not.**

No overthinking. No debate.
Just momentum.

**Vibe it. Build it. Ship it.**

## Features

- Translate plain English commands to ffmpeg commands
- Support for multiple media formats
- Interactive and direct command modes
- Dry-run functionality
- Deterministic and inspectable command generation

## Installation

### As a Binary

You can install ffrs using Cargo:

```bash
cargo install ffrs
```

### From Source

```bash
git clone https://github.com/darkterminal/ffrs.git
cd ffrs
cargo install --path .
```

## Usage

### Command Line Interface

```bash
# Convert a video file
ffrs "convert video.mp4 to video.avi"

# Interactive mode
ffrs --interactive

# Dry run (shows command without executing)
ffrs --dry-run "convert video.mp4 to video.avi"

# Specify output directory
ffrs --output /path/to/output "convert video.mp4 to video.avi"
```

### As a Library

Add to your `Cargo.toml`:

```toml
[dependencies]
ffrs = "0.1.0"
```

Use in your code:

```rust
use ffrs::{Tokenizer, Parser, CommandBuilder};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Tokenize the command
    let mut tokenizer = Tokenizer::new("convert video.mp4 to video.avi");
    let tokens = tokenizer.tokenize();

    // Parse the tokens into an intent
    let mut parser = Parser::new(tokens);
    let intent = parser.parse()?;

    // Build the ffmpeg command
    let cmd_builder = CommandBuilder::new();
    let ffmpeg_cmd = cmd_builder.build_command(&intent)?;

    println!("Generated command: {}", ffmpeg_cmd);

    Ok(())
}
```

## Supported Formats

- Video: MP4, AVI, MOV, WMV, MKV, WebM
- Audio: MP3, WAV, FLAC
- Images: JPG, PNG, GIF

## License

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