https://github.com/levkush/termvideo

Play videos from a terminal with audio support! 🚀
https://github.com/levkush/termvideo

cli contributions-welcome ffmpeg go golang terminal video youtube

Last synced: about 1 year ago
JSON representation

Play videos from a terminal with audio support! 🚀

• Host: GitHub
• URL: https://github.com/levkush/termvideo
• Owner: levkush
• License: mit
• Created: 2024-03-15T01:12:02.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-03-24T00:10:27.000Z (about 2 years ago)
• Last Synced: 2025-05-07T18:13:02.159Z (about 1 year ago)
• Topics: cli, contributions-welcome, ffmpeg, go, golang, terminal, video, youtube
• Language: Go
• Homepage:
• Size: 3.92 MB
• Stars: 11
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![Preview](./screenshot.png)

# TermVideo 🎬

![GitHub](https://img.shields.io/github/license/levkush/termvideo)

![GitHub last commit](https://img.shields.io/github/last-commit/levkush/termvideo)

Play your videos from a terminal with audio! 🚀

## Description

TermVideo is a terminal video player written in Go that will help you play your favorite videos in a terminal. Supports Windows, Mac and Linux.

## Features

- Play videos with audio

- Customize video's quality

- Colored terminal output

- Youtube video support

## Usage

### Installation

1. Install ![ffmpeg](https://ffmpeg.org/)

2. Go to the ![Releases](https://github.com/levkush/termvideo/releases) tab

3. Download the latest release file for your OS

### Example Usage

#### Open a local file in quality 8

```bash

termvideo -q 8 Rickroll.mp4

```

#### Play a YouTube video

```bash

termvideo https://www.youtube.com/watch?v=dQw4w9WgXcQ

```

## Goals

* ❌ Fix some audio issues

* ❌ Improve performance

* ❌ Add comments

* ✅ Improve README.md

## Contributing

Feel free to contribute by opening issues or submitting pull requests. Your input is highly appreciated! 🙌

## Honorable mentions 🙏

- [AlexEidt/vidio](https://github.com/AlexEidt/Vidio) for the video processing library.

- [AlexEidt/aio](https://github.com/AlexEidt/aio) for the audio processing library.

- [ytdl-org/youtube-dl](https://github.com/ytdl-org/youtube-dl) for the youtube video downloading.

## License

This project is licensed under the [MIT License](https://choosealicense.com/licenses/mit/).