https://github.com/danillut/ytr
ytr (YouTube Randomizer) is a simple terminal-based application for managing a collection of YouTube videos.
https://github.com/danillut/ytr
Last synced: 3 months ago
JSON representation
ytr (YouTube Randomizer) is a simple terminal-based application for managing a collection of YouTube videos.
- Host: GitHub
- URL: https://github.com/danillut/ytr
- Owner: DanilLut
- License: mit
- Created: 2025-02-04T16:32:12.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-03-02T09:05:07.000Z (4 months ago)
- Last Synced: 2025-03-02T09:29:44.881Z (4 months ago)
- Language: Go
- Homepage:
- Size: 7.81 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ytr - YouTube Randomizer
ytr (YouTube Randomizer) is a simple terminal-based application for managing a collection of YouTube videos. It allows users to add videos, list them, delete entries, and open a random video in the web browser.
## Features
- Add YouTube videos to the saved list
- Play a random video from the saved list
- Manage videos in a TUI (add, search, delete, play random, play selected)
## Installation
```sh
go install github.com/DanilLut/ytr@latest
```
### Install wslu, if using WSL:
```sh
sudo apt install wslu
```
## Usage
Run the program with different options:
### Play a random video from the saved list (removes video from the list automatically)
```sh
ytr
```
### Add a YouTube video
```sh
ytr
```
### Launch TUI mode
```sh
ytr -t
```
### Show help
```sh
ytr -h
```
## Configuration & Storage
The application stores video entries in a JSON database located at:
- **Linux/macOS/WSL**: `~/.config/ytr/data.json`
- **Windows**: `%APPDATA%\ytr\data.json`
## Dependencies
This project uses the following Go libraries:
- [Bubble Tea](https://github.com/charmbracelet/bubbletea) for the TUI
- [Lip Gloss](https://github.com/charmbracelet/lipgloss) for styling
- [Color](https://github.com/fatih/color) for colored output
## License
This project is licensed under the MIT License. See `LICENSE` for details.
## Contributions
Pull requests and feature suggestions are welcome! Feel free to open an issue or contribute to the project.