forked from github-mirror/Verome-API
91
README.md
91
README.md
@@ -2,7 +2,7 @@
|
|||||||
<img src="assets/Logo.png" alt="Virome API" width="120">
|
<img src="assets/Logo.png" alt="Virome API" width="120">
|
||||||
|
|
||||||
<h1 style="margin:0; font-size:60px; line-height:1;">
|
<h1 style="margin:0; font-size:60px; line-height:1;">
|
||||||
Virome API
|
Muza API
|
||||||
</h1>
|
</h1>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
@@ -17,7 +17,6 @@
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
- Search songs, albums, artists with fallback video IDs for playback
|
- Search songs, albums, artists with fallback video IDs for playback
|
||||||
- Get synced lyrics (LRC format)
|
- Get synced lyrics (LRC format)
|
||||||
- Stream audio via Piped/Invidious proxies
|
- Stream audio via Piped/Invidious proxies
|
||||||
@@ -27,93 +26,5 @@
|
|||||||
- Built-in music player with YouTube IFrame API
|
- Built-in music player with YouTube IFrame API
|
||||||
- Auto region detection from IP
|
- Auto region detection from IP
|
||||||
|
|
||||||
## Quick Start
|
|
||||||
|
|
||||||
```bash
|
|
||||||
deno run --allow-net --allow-env --allow-read mod.ts
|
|
||||||
```
|
|
||||||
|
|
||||||
Server runs at `http://localhost:8000`
|
|
||||||
|
|
||||||
## API Endpoints
|
|
||||||
|
|
||||||
### Search
|
|
||||||
|
|
||||||
| Endpoint | Description |
|
|
||||||
|----------|-------------|
|
|
||||||
| `/api/search?q=&filter=` | Search YouTube Music (songs/albums/artists) |
|
|
||||||
| `/api/yt_search?q=&filter=` | Search YouTube (videos/channels/playlists) |
|
|
||||||
| `/api/search/suggestions?q=` | Autocomplete suggestions |
|
|
||||||
|
|
||||||
### Content
|
|
||||||
|
|
||||||
| Endpoint | Description |
|
|
||||||
|----------|-------------|
|
|
||||||
| `/api/songs/:videoId` | Song details with artist/album links |
|
|
||||||
| `/api/albums/:browseId` | Album with tracks and artist |
|
|
||||||
| `/api/artists/:browseId` | Artist with discography |
|
|
||||||
| `/api/playlists/:playlistId` | Playlist tracks |
|
|
||||||
| `/api/chain/:videoId` | Full chain: Song → Artist → Albums |
|
|
||||||
|
|
||||||
### Discovery
|
|
||||||
|
|
||||||
| Endpoint | Description |
|
|
||||||
|----------|-------------|
|
|
||||||
| `/api/related/:videoId` | Related songs |
|
|
||||||
| `/api/radio?videoId=` | Generate radio mix |
|
|
||||||
| `/api/similar?title=&artist=` | Similar tracks |
|
|
||||||
| `/api/charts?country=` | Music charts |
|
|
||||||
| `/api/trending?country=` | Trending music |
|
|
||||||
| `/api/moods` | Mood categories |
|
|
||||||
| `/api/top/artists?country=` | Top artists |
|
|
||||||
| `/api/top/tracks?country=` | Top tracks |
|
|
||||||
|
|
||||||
### Streaming & Lyrics
|
|
||||||
|
|
||||||
| Endpoint | Description |
|
|
||||||
|----------|-------------|
|
|
||||||
| `/api/stream?id=` | Audio stream URLs |
|
|
||||||
| `/api/proxy?url=` | Audio proxy (CORS bypass) |
|
|
||||||
| `/api/lyrics?title=&artist=` | Synced lyrics (LRC) |
|
|
||||||
|
|
||||||
### Info
|
|
||||||
|
|
||||||
| Endpoint | Description |
|
|
||||||
|----------|-------------|
|
|
||||||
| `/api/artist/info?artist=` | Artist bio (Last.fm) |
|
|
||||||
| `/api/track/info?title=&artist=` | Track info (Last.fm) |
|
|
||||||
|
|
||||||
## Examples
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Search songs
|
|
||||||
curl "https://verome-api.deno.dev/api/search?q=Blinding%20Lights&filter=songs"
|
|
||||||
|
|
||||||
# Get lyrics
|
|
||||||
curl "https://verome-api.deno.dev/api/lyrics?title=Blinding%20Lights&artist=The%20Weeknd"
|
|
||||||
|
|
||||||
# Stream URLs
|
|
||||||
curl "https://verome-api.deno.dev/api/stream?id=4NRXx6U8ABQ"
|
|
||||||
|
|
||||||
# Radio mix
|
|
||||||
curl "https://verome-api.deno.dev/api/radio?videoId=4NRXx6U8ABQ"
|
|
||||||
```
|
|
||||||
|
|
||||||
## Project Structure
|
|
||||||
|
|
||||||
```
|
|
||||||
mod.ts - Server and routes
|
|
||||||
lib.ts - API clients (YT Music, YouTube, Last.fm, LRCLib)
|
|
||||||
ui.ts - Web UI
|
|
||||||
assets/ - Logo
|
|
||||||
```
|
|
||||||
|
|
||||||
## Deploy
|
|
||||||
|
|
||||||
```bash
|
|
||||||
deployctl deploy --project=verome-api --prod mod.ts
|
|
||||||
```
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
MIT
|
MIT
|
||||||
|
|||||||
Reference in New Issue
Block a user