Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/exponefrv1/univk_audio
An easy-to-use library that allows you to search and download audio from VK, bypassing the restriction on obtaining a token to use the VK audio API.
https://github.com/exponefrv1/univk_audio
audio audio-library music music-downloader music-library vk vk-audio vk-music vk-music-downloader vk-musicaudio vkontakte
Last synced: 1 day ago
JSON representation
An easy-to-use library that allows you to search and download audio from VK, bypassing the restriction on obtaining a token to use the VK audio API.
- Host: GitHub
- URL: https://github.com/exponefrv1/univk_audio
- Owner: Exponefrv1
- License: mit
- Created: 2023-08-10T09:38:02.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-01-23T15:50:22.000Z (8 months ago)
- Last Synced: 2024-04-23T23:46:53.901Z (5 months ago)
- Topics: audio, audio-library, music, music-downloader, music-library, vk, vk-audio, vk-music, vk-music-downloader, vk-musicaudio, vkontakte
- Language: Python
- Homepage: https://pypi.org/project/univk-audio/
- Size: 105 KB
- Stars: 13
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ⚠️ The library doesn't work and deprecated. Do not use it in your projects.
[](https://badge.fury.io/py/univk-audio)
[](https://scrutinizer-ci.com/g/Exponefrv1/univk_audio/?branch=main)
[](https://scrutinizer-ci.com/g/Exponefrv1/univk_audio/build-status/main)
[](https://scrutinizer-ci.com/code-intelligence)
[](https://app.codacy.com/gh/Exponefrv1/univk_audio/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
# Search and download songs from VK easily with univk_audio
An easy-to-use library that allows you to search and download audio from VK, bypassing the restriction on obtaining a token to use the VK audio API.
## Key features
* Doesn't require a VK Audio API token
* Login + password authorization
* Searching for songs without specific query rules
* Downloading songs
* Supports async
## Requirements
* [aiofiles](https://pypi.org/project/aiofiles/)
* [aiohttp](https://pypi.org/project/aiohttp/)
* [beautifulsoup4](https://pypi.org/project/beautifulsoup4/)
* [httpx](https://pypi.org/project/httpx/)
* [lxml](https://pypi.org/project/lxml/)
## Installation
```
pip install univk_audio
```
## Getting started
### Get authorization cookies
#### As class object:
```python3
# examples/auth_example.py
import asyncio
from univk_audio import AsyncVKAuth
# Example with class object, needs to close session manually
async def get_auth_cookies_example():
login: str = "79998887776"
password: str = "password"
# user_agent is optional:
user_agent: str = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36"
auth = AsyncVKAuth(login = login, password = password, user_agent = user_agent)
# .get_auth_cookies Returns a string with cookies
# path is optional, if specified - saves cookies in file
cookies = await auth.get_auth_cookies(path = "cookies.txt")
await auth.close()
print(cookies)
asyncio.run(get_auth_cookies_example())
```
#### Async with:
```python3
# examples/auth_with_example.py
import asyncio
from univk_audio import AsyncVKAuth
# Example with 'async with' construction, that closes session automatically
async def get_auth_cookies_with_example():
login: str = "79998887776"
password: str = "password"
# user_agent is optional:
user_agent: str = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36"
async with AsyncVKAuth(login = login, password = password, user_agent = user_agent) as auth:
# .get_auth_cookies Returns a string with cookies
# path is optional, if specified - saves cookies in file
cookies = await auth.get_auth_cookies(path = "cookies.txt")
print(cookies)
asyncio.run(get_auth_cookies_with_example())
```
### Search for songs
#### As class object:
```python3
# examples/search_example.py
import asyncio
from univk_audio import AsyncVKMusic
# Example with class object, needs to close session manually
async def search_example():
cookies: str = "Your cookies from auth. See -> examples/auth_example.py"
# user_agent is optional:
user_agent: str = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36"
music = AsyncVKMusic(cookies = cookies, user_agent = user_agent)
# .search Returns a Dict[str, str]
# {"*song-title*": "*download-link*"}
search_results = await music.search(query = "Imagine Dragons - Bones")
await music.close()
for title, download_link in search_results.items():
print(f"{title}\n{download_link}\n" + "-" * 15)
asyncio.run(search_example())
```
#### Async with:
```python3
# examples/search_with_example.py
import asyncio
from univk_audio import AsyncVKMusic
# Example with 'async with' construction, that closes session automatically
async def search_with_example():
cookies: str = "Your cookies from auth. See -> auth_example.py"
# user_agent is optional:
user_agent: str = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36"
async with AsyncVKMusic(cookies = cookies, user_agent = user_agent) as music:
# .search Returns a Dict[str, str]
# {"*song-title*": "*download-link*"}
search_results = await music.search(query = "Imagine Dragons - Bones")
for title, download_link in search_results.items():
print(f"{title}\n{download_link}\n" + "-" * 15)
asyncio.run(search_with_example())
```
### Search and download songs
#### General example of downloading songs from search results:
```python3
# examples/search_and_download_example.py
import asyncio
from univk_audio import AsyncVKMusic
# General example of downloading songs from search results
async def search_and_download_example():
cookies: str = "Your cookies from auth. See -> auth_example.py"
# user_agent is optional:
user_agent: str = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36"
async with AsyncVKMusic(cookies = cookies, user_agent = user_agent) as music:
# Returns a Dict[str, str]
# {"*song-title*": "*download-link*"}
search_results = await music.search(query = "Imagine Dragons - Bones")
for title, download_link in search_results.items():
print("Downloading...\n" + f"{title}\n{download_link}")
is_downloaded = await music.download(link = download_link, path = f"songs/{title}.mp3")
if is_downloaded:
print(f"File saved as {title}.mp3\n" + "-" * 15)
asyncio.run(search_and_download_example())
```
## License
```univk_audio``` is offered under MIT License.
Free copying and use is allowed.
## Source code
https://github.com/Exponefrv1/univk_audio
## Author
Discord: autumnale
Telegram: [@AnemoneSong](https://t.me/AnemoneSong)
* I don't ask for donations or something.
* Any questions, suggestions and crit are welcome.