![preview01](https://github.com/buzz-lightsnack-2007/Kpopminal/blob/main/preview/preview01.png?raw=true)

# Kpop'minal
Watch K-pop music videos in an ASCII format. 

_Uses [`video-to-ascii` by joelibaceta](https://github.com/joelibaceta/video-to-ascii)_. 

[**▶︎ Run**](https://colab.research.google.com/github/buzz-lightsnack-2007/Kpopminal/blob/main/Kpop'minal.ipynb)

## How it came
One thing fascinating about command lines is that they can do many things that GUIs do, such as moving files, editing files, etc. 

However, there are some things that CLIs can't do. You can't watch videos in there out of the box. 

But there is _The Matrix_ that plays in ASCII. You can also watch a recreated _Star Wars_ just by using the `telnet` command. 

**So what about watching k-pop videos in the terminal?** 

With the help of [joelibaceta's `video-to-ascii`](https://github.com/joelibaceta/video-to-ascii), this is actually possible. 

## What it does
Give the artist name, give the music video name, and run. 

A script will be downloaded containing the ASCII version of the k-pop music video. This only works in POSIX and Linux OSes. 

[**And get a taste of it here.**](https://colab.research.google.com/github/buzz-lightsnack-2007/Kpopminal/blob/main/Kpop'minal.ipynb)

## Planned
- localization
- custom resolution
- **more artists**
    - Yes: right now, it is only linked to TWICE MVs. More info to contribute to this below! 

## About Copyright
The rights of these videos go to their artists and their entertainment agencies. In addition, this script is not affiliated with these bodies. 

## How to contribute
Yes, I'd love to receive feedback. Kindly let me know what you think in the [Disccusions](https://github.com/buzz-lightsnack-2007/Kpopminal/discussions/categories/ideas-and-feedback) page! 

When you would want to include a new music video, kindly make a [new discussion](https://github.com/buzz-lightsnack-2007/Kpopminal/discussions/categories/music-videos) mentioning the name and the _direct_ download URL of the video.