Skip to content
This repository was archived by the owner on Jun 3, 2024. It is now read-only.

Commit 5bd8a23

Browse files
committed
add readme
1 parent 46940b9 commit 5bd8a23

20 files changed

+227
-34
lines changed

README.md

Lines changed: 76 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,77 @@
1-
# mmdl
1+
![carbon](./carbon.svg)
2+
3+
# mmdl - Mega Music Downloader
4+
5+
![License](https://img.shields.io/pypi/l/mmdl?style=for-the-badge) ![PyPI](https://img.shields.io/pypi/v/mmdl?style=for-the-badge) ![Downloads](https://img.shields.io/pypi/dw/mmdl?style=for-the-badge)
6+
7+
## What is mmdl ❓
8+
9+
MMDL is a cli app which allows you to quickly and efficiently download one or multiple songs from YouTube.
10+
11+
### Why
12+
13+
- 🕖 Fast: Thanks to *async code* and *multithreading*.
14+
- ⚡ Simple: Type `mmdl go` and get started with downloading songs.
15+
- ✨ Powerful
16+
- Find songs based on songs query/title
17+
- Skip already existing songs
18+
- Add metadata such as artist name and artwork
19+
20+
## Requirements 👇
21+
22+
- Python 3
23+
- FFmpeg
24+
25+
## Install ❤️
26+
27+
```bash
28+
pip install mmdl
29+
```
30+
31+
**That’s it! **
32+
33+
## Usage 🔥
34+
35+
### Go
36+
37+
*Very quick and easy way of running the cli. Few questions will be asked via prompts. **This is the recommended way!***
38+
39+
```shell
40+
mmdl go
41+
```
42+
43+
### Download
44+
45+
*Fast and traditional way of running the cli. Pass arguments and have your songs downloaded. Useful for automation scripts.*
46+
47+
```shell
48+
mmdl download <method> #(add -h for more information)
49+
```
50+
51+
#### Methods
52+
53+
- File `mmdl download file <location>`: Get songs from file. Then download them.
54+
- List `mmdl download list "Term1" "Term2" ...` or `mmdl download list -a` for a prompt: Add multiple songs as cli arguments or enter them in a prompt.
55+
- YTMusic (beta) `mmdl download ytmusi` : Download multiple songs from *YouTube Music liked songs playlist* (via parsing HTML)
56+
- Single `mmdl download single song name`: Download a single song.
57+
58+
## Support ⚡
59+
60+
### Bugs 🐛
61+
62+
Please [open a issue](https://github.com/techboy-coder/mmdl/issues/new) with some information to reproduce your problem.
63+
64+
### Questions ❓
65+
66+
Please [start/check a discussion](https://github.com/techboy-coder/mmdl/discussions/new).
67+
68+
## Contributing 🤜
69+
70+
We welcome contributions very much. They are appreciated.
71+
72+
### Steps
73+
74+
1. Check for bugs/issues you would like to solve.
75+
2. Fork the repo and make your changes.
76+
3. Send a pull request.
277

3-
Mmdl [Mega Music Downloader] - A tool to easily download music.

build/lib/mmdl/__init__.py

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1 @@
1-
#comment
2-
import os
3-
import sys
4-
sys.path.append(os.path.abspath(os.path.join(os.path.dirname("__file__"), '..')))
5-
from cli import runme
1+
from .mdl import *

build/lib/mmdl/cli.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515
from lxml.html import fromstring
1616
import click
1717
from mmdl import MusicDownloader
18-
from ask import asker
18+
from .ask import asker
1919
from rich.console import Console
2020
import questionary
2121
console = Console()
@@ -318,7 +318,7 @@ def single(song, verbose, debug):
318318

319319

320320
def runme():
321-
main
321+
main()
322322
if __name__ == '__main__':
323323
runme()
324324
# :/

build/lib/mmdl/mdl.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,10 +27,10 @@
2727
# pretty.install()
2828
from rich.progress import track
2929

30-
from globals import console
30+
from .globals import console
3131

32-
from utils import Utils
33-
from yt_utils import YtdlUtils
32+
from .utils import Utils
33+
from .yt_utils import YtdlUtils
3434

3535

3636
##Dev Dep

build/lib/mmdl/yt_utils.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
from __future__ import unicode_literals
2-
from utils import Utils
2+
from .utils import Utils
33
import youtube_dl
44
from youtubesearchpython.__future__ import VideosSearch
55
from ytmusicapi import YTMusic
@@ -8,7 +8,7 @@
88
import os
99
import eyed3
1010
import urllib
11-
from globals import console
11+
from .globals import console
1212

1313

1414
class YtdlUtils():

carbon.svg

Lines changed: 125 additions & 0 deletions
Loading

dist/mmdl-0.0.11-py3-none-any.whl

10.6 KB
Binary file not shown.

dist/mmdl-0.0.11.tar.gz

8.98 KB
Binary file not shown.

dist/mmdl-0.0.5-py3-none-any.whl

-10.5 KB
Binary file not shown.

dist/mmdl-0.0.5.tar.gz

-9 KB
Binary file not shown.

0 commit comments

Comments
 (0)