16 releases

Uses new Rust 2024

new 0.0.18 Nov 10, 2025
0.0.17 Nov 5, 2025
0.0.14 Oct 31, 2025
0.0.6 Sep 29, 2025

#387 in Command line utilities

Download history 289/week @ 2025-09-22 192/week @ 2025-09-29 18/week @ 2025-10-06 11/week @ 2025-10-13 3/week @ 2025-10-20 256/week @ 2025-10-27

296 downloads per month

MIT/Apache

740KB
4K SLoC

tvid

This project is under active development. Features and functionality may change.

tvid is a command-line video player written in Rust, utilizing FFmpeg for media decoding and playback. It supports video, audio, and subtitle streams, and provides a terminal-based user interface for interactive control.

Features (TODO)

  • Play various video and audio formats via FFmpeg
  • Terminal-based UI for playback control
  • Subtitle support
  • Playlist management
  • Audio and video stream selection
  • Keyboard shortcuts for common actions

Requirements

  • Rust (latest stable version recommended)
  • FFmpeg libraries installed on your system

Build & Run

  1. Clone the repository:

    git clone https://github.com/copi143/tvid.git
    cd tvid
    
  2. Build the project:

    cargo build --release
    
  3. Run the player:

    cargo run -- <video-file>
    

    Or use the compiled binary in target/release/tvid.

Usage

tvid <video-file> [video-file] ...

Options (TODO)

  • --playlist <file>: Load a playlist file
  • --subtitle <file>: Load external subtitle

Keyboard Shortcuts (TODO)

  • Space: Play/Pause
  • q: Quit
  • /: Seek backward/forward
  • /: Volume up/down
  • s: Toggle subtitles

License

This project is dual-licensed under either:

at your option.

You can choose either license according to your needs.

Dependencies

~8–42MB
~583K SLoC