BUDDY v0.1.2 — Audio Support Added

BUDDY v0.1.2

Block-based Unicode Direct-color Display Yield

What's New ?

• Audio support added completely for Windows dist
• Efficient frame rendering
• [Edit : ] Native Frame Cap

Windows

Download buddy.exe, add it to PATH, done.

Linux

Note : Linux audio is being worked on — WSL2 in particular has limitations with how audio devices are exposed that we're working around. For now, use --no-audio on Linux if you hit issues. Next major release is gonna fix this soon

Install dependencies for buddy in linux for audio support:

sudo apt install libportaudio2

Download buddy-linux-x86_64, then:

sudo cp buddy-linux-x86_64 /usr/local/bin/buddy
sudo chmod +x /usr/local/bin/buddy

Then just:

buddy video.mp4

For no audio output:

buddy video.mp4 --no-audio

That's it. No Python, no installs, no setup.

---

Usage

buddy <video>                   Play a video (uses defaults)
buddy play <video> [options]    Play with explicit options
buddy modes                     List render modes
buddy help                      Show help

Options

-m, --mode   MODE    Render mode: half | ascii | braille  (default: half)
-q, --quality  N     Quality level: 1, 2, or 3            (default: 2)
-s, --scale    F     Fraction of terminal to fill, 0.1-1.0 (default: 1.0)
    --loop           Loop the video indefinitely
    --no-info        Hide the status bar at the bottom
    --no-audio       Disable audio output

Examples

# Play with all defaults
buddy video.mp4

# Best quality downscaling
buddy video.mp4 -q 3

# Braille mode, loop forever
buddy video.mp4 -m braille --loop

# Use 80% of the terminal, no status bar
buddy video.mp4 -s 0.8 --no-info

# Classic ASCII art look
buddy video.mp4 -m ascii

# Explicit play subcommand (same result)
buddy play video.mp4 -m half -q 3 -s 0.9

# Explicit no audio option
buddy play video.mp4 --no-audio

---

For Source install see the README.md

BUDDY v0.1.1 — Initial Release

BUDDY v0.1.1

Block-based Unicode Direct-color Display Yield

Windows

Download buddy.exe, add it to PATH, done.

Linux

Download buddy-linux-x86_64, then:

sudo cp buddy-linux-x86_64 /usr/local/bin/buddy
sudo chmod +x /usr/local/bin/buddy

Then just:

buddy video.mp4

That's it. No Python, no installs, no setup.

---

Usage

buddy <video>                   Play a video (uses defaults)
buddy play <video> [options]    Play with explicit options
buddy modes                     List render modes
buddy help                      Show help

Options

-m, --mode   MODE    Render mode: half | ascii | braille  (default: half)
-q, --quality  N     Quality level: 1, 2, or 3            (default: 2)
-s, --scale    F     Fraction of terminal to fill, 0.1-1.0 (default: 1.0)
    --loop           Loop the video indefinitely
    --no-info        Hide the status bar at the bottom

Examples

# Play with all defaults
buddy video.mp4

# Best quality downscaling
buddy video.mp4 -q 3

# Braille mode, loop forever
buddy video.mp4 -m braille --loop

# Use 80% of the terminal, no status bar
buddy video.mp4 -s 0.8 --no-info

# Classic ASCII art look
buddy video.mp4 -m ascii

# Explicit play subcommand (same result)
buddy play video.mp4 -m half -q 3 -s 0.9

---

For Linux and source install see the README.md