Metadata-Version: 2.1
Name: tubemp3
Version: 0.3.6.3b0
Summary: Library for getting music and video in high quality from YouTube
Home-page: https://github.com/reinanbr/tubemp3
Author: Reinan Br
Author-email: slimchatuba@gmail.com
License: MIT License
Keywords: video mp3 m4a mp4 youtube music download
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: tqdm
Requires-Dist: mutagen
Requires-Dist: requests
Requires-Dist: yt-dlp

<br/>
<p align="center">
  <a href="https://github.com/perseu912">
    <img title="Autor" src="https://img.shields.io/badge/Autor-reinan_br-blue.svg?style=for-the-badge&logo=github">
  </a>
</p>

<p align="center">
  <!-- PyPI -->
  <a href="https://pypi.org/project/tubemp3/"><img src="https://img.shields.io/pypi/v/tubemp3?style=flat-square"></a>
  <a href="#"><img src="https://img.shields.io/pypi/wheel/tubemp3?style=flat-square"></a>
  <a href="#"><img src="https://img.shields.io/pypi/dm/tubemp3?style=flat-square"></a>
  <img src="https://img.shields.io/pypi/l/tubemp3?style=flat-square&color=orange">

<!-- Sistema -->

<br/>
  <img src="https://img.shields.io/badge/system-linux%20%7C%20deb-brightgreen?style=flat-square">
  <img src="https://img.shields.io/github/pipenv/locked/python-version/perseu912/tubemp3?style=flat-square">

<!-- Social -->

<br/>
  <a href="https://instagram.com/reysofts/"><img src="https://img.shields.io/badge/insta-reysofts-darkviolet?logo=instagram&style=flat-square"></a>
</p>

<p align="center"><b>Library for downloading and converting YouTube music to MP3.<br>(for Only System Linux).</b></p>

<hr/>

## 📦 Installation

```bash
sudo apt update && sudo apt upgrade -y
sudo apt install ffmpeg -y
pip3 install tubemp3 -U
```

---

## 🖥️ Usage

### 🔹 CLI Example

```bash
tubemp3 "https://music.youtube.com/watch?v=Wy_6jN1Yrx8&si=pgL_4Ozjafkkms8X" "/sdcard/Alarms/root_kali.mp3"
```

<details>
  <summary><b>Sample Output</b></summary>

```txt
tube search info:
file: /sdcard/Alarms/root_kali.mp3
link: https://music.youtube.com/watch?v=Wy_6jN1Yrx8&si=pgL_4Ozjafkkms8X
search: False
info music link:
'title': '3.1_4-root@kali.0cc'
'artist': 'Mac Quayle'
'album': 'Mr. Robot, Vol. 5'
'duration': '152'
'format': 'webm'
'filesize': '3091263'
...
converting to MP3...
saving metadata...
```

</details>

---

### 🔹 Python API

#### 🔸 Download via URL

```python
from tubemp3.api import get_info_link as gil
from tubemp3.file import download

music = gil("https://music.youtube.com/watch?v=yspAcpXEzSM")
download(music)
```

#### 🔸 Search and Download

```python
from tubemp3.api import search_music
from tubemp3.file import download

music = search_music("like a player wolverine deadpool chor")[0]
download(music)
```

#### 🔸 Get Metadata Only

```python
from tubemp3.api import search_music

query = "like a player wolverine deadpool chor"
music = search_music(query)[0]

for key, value in music.items():
    print(f"{key}: {value}")
```

---


`<img src="https://reysofts.com/evox/api/save_access_lib.php?key_lib=tubemp3_py">`

<p align='center'></p>
