Skip to content

Latest commit

 

History

54 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GeethLe (गीत ले) - Search for Songs from Anywhere!

⚠️ some features stopped working due to the latest changes to the Spotify API switching to a paid-only model. Working on figuring out a fix - but might take a bit of time! more details on this issue

What?

GeethLe makes sharing music easy! Search for any song from anywhere with geethle.tech/<your+fav+song> and instantly get a permalink to the song along with a thumbnail with metadata. It’ll redirect you to YouTube Music, saving time when sharing tracks.

Sooo, say you're talking to someone over WhatsApp & want to mention about a song. And, you're too lazy to go find the link. :D Don't worry, I have your back!

https://geethle.tech/<query>

GeethLe finds the track, generates a custom thumbnail with metadata + it redirects to YouTube Music once you click on the link. 🙂

How to use?

  • https://geethle.tech/<query>

Architecture

  ┌──────────────────────────────────────────────┐
  │              geethle.tech                    │
  └───────────────────┬──────────────────────────┘
                      │
                      ▼
                 /<query>
                      │
                      ▼
  ┌───────────────────────────────────────────────┐
  │                  app.py                       │
  │              (Flask Routes)                   │
  └───────────────────┬───────────────────────────┘
                      │
                      ▼
  ┌──────────────────────────────────────────────┐
  │               geeth_le.py                    │
  │           (Core Business Logic)              │
  │                                              │
  │  search_music()  ──► iTunes Search API       │
  │               │                              │
  │               ▼                              │
  │  ┌─────────────────────────────────┐         │
  │  │  _generate()                    │         │
  │  │  Download album art             │         │
  │  │  Overlay title + artist + album │         │
  │  │  (Pillow + Geist font)          │         │
  │  └────────────┬────────────────────┘         │
  │               ▼                              │
  │  ┌─────────────────────────────────┐         │
  │  │  _supabase_upload_frame()       │         │
  │  │  Upload to Supabase Storage     │         │
  │  │  Return signed URL (15-day TTL) │         │
  │  └─────────────────────────────────┘         │
  │               │                              │
  │               ▼                              │
  │  ┌─────────────────────────────────┐         │
  │  │  _find_yt_music_link()          │         │
  │  │  ytmusicapi search              │         │
  │  └─────────────────────────────────┘         │
  └───────────────────┬──────────────────────────┘
                      │
                      ▼
  ┌───────────────────────────────────────────────┐
  │            index.html (Template)              │
  │                                               │
  │  - OG / Twitter Card meta tags                │
  │    (title, description, thumbnail URL)        │
  │  - JS redirect to YouTube Music               │
  └───────────────────┬───────────────────────────┘
                      │
                      ▼
                YouTube Music

External APIs

  ┌──────────────┐    ┌──────────────┐    ┌──────────────────────┐
  │  iTunes API  │    │  ytmusicapi  │    │  Supabase Storage    │
  │              │    │              │    │                      │
  │  - Search    │    │  - Song      │    │  - Thumbnail hosting │
  │  - Metadata  │    │    lookup    │    │  - Signed URLs       │
  │  - Album art │    │              │    │                      │
  └──────────────┘    └──────────────┘    └──────────────────────┘

Credits

Example

About

Search for Songs from Anywhere with GeethLe! (गीत ले)

Topics

Resources

Stars

13 stars

Watchers

1 watching

Forks

Used by

Contributors

Languages