iS"ddlZddlZddlZddlmZmZmZmZddlmZddl m Z ddl m Z ddl mZmZmZddlmZdd lmZmZdd lmZdd lmZdd lmZdd lmZmZddlmZddl m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'ddl&m(Z(GddeZ)dS)N)DictAnyUnionList)Optional)ExponentialRetry) AudioSegment) Recognizer Signature SearchParams) HTTPClient) Converter GeoService) deprecated) GenreMusic)HTTPClientInterface)RequestDevice) ShazamUrl) ArtistQuery)DecodedMessage) CountryCode)ArtistQueryGenerator)get_songceZdZdZ d3dededeed effd Z d4d ededeede ee ffdZ d5dedee deede ee ffdZ d6dedeede ee ffdZ d4ded ededeede ee ff dZ d4deded ededeede ee ff dZ d7deeefd ededeede ee ff dZ d4dedeeefd ededeede ee ff dZ d8ded ededeede ee ff d Z d9ded ededeede ee ff d!Z d9ded ededeede ee ff d"Z d6dedeede ee ffd#Z d6d$eedeedee ee ffd%Z d9ded ededeefd&Z d6d'edeefd(Z d6d)edeede ee ffd*Zed+ d6d,eeej e!e"e#fdeede ee ffd-Z$ d6d.e%deede ee ffd/Z& d5d,eee!e"fdeed0ee'de ee ffd1Z( d6d.e)deede ee ffd2Z*xZ+S):Shazamz{ Is asynchronous framework for reverse engineered Shazam API written in Python 3.10+ with asyncio and aiohttp. en-USGBN languageendpoint_country http_clientsegment_duration_secondsct|t||_||_||_|p!t tddhd|_t|j|_ dS)Nr!)r$<>)attempts max_timeoutstatuses) retry_options) super__init__r core_recognizerr!r"rrr#r geo_service)selfr!r"r#r$ __class__s T/root/.openclaw/workspace/.venvs/songid/lib/python3.11/site-packages/shazamio/api.pyr3zShazam.__init__s (+++)%=   ! 0& **222+ + + &d&677rlimitoffsetproxyreturnc K|jd{V}|jdtj||j|j||| |d{VS)a Search top world tracks :param limit: Determines how many songs the maximum can be in the request. Example: If 5 is specified, the query will return no more than 5 songs. :param offset: A parameter that determines with which song to display the request. The default is 0. If you want to skip the first few songs, set this parameter to your own. :param proxy: Proxy server :return: dict tracks NGET playlist_idr!r"r;r<headersr=) r5get_topr#requestrTOP_TRACKS_PLAYLISTformatr!r"rD)r6r;r<r=top_playlist_ids r8top_world_trackszShazam.top_world_tracks7s$!% 0 8 8 : :::::::%--   ) 0 0+!%!6 1  LLNN.         r9 artist_idquerycK|r%t|}|}ni}|jdtj|j||||d{VS)a" Retrieving information from an artist profile :param artist_id: Artist number. Example (203347991) :param query: Foo https://www.shazam.com/artist/203347991/ :param proxy: Proxy server :return: dict about artist )sourcer@)r"rKparamsrDr=N) rrPr#rFrSEARCH_ARTIST_V2rHr"rD)r6rKrLr=pg params_dicts r8 artist_aboutzShazam.artist_aboutWs  %U333B))++KKK%--   & - -!%!6# .  LLNN.         r9track_idcK|jdtj|j|j|||d{VS)z Get track information :param track_id: Track number. Example: (549952578) https://www.shazam.com/track/549952578/ :param proxy: Proxy server :return: dict about track r@)r!r"rUrCN)r#rFr ABOUT_TRACKrHr!r"rDr6rUr=s r8 track_aboutzShazam.track_aboutxs%--   ! ( (!%!6! )   LLNN.         r9 country_codec (K|jt|d{V}|jdt j||j|j |||| |d{VS)a Get the best tracks by country code https://www.shazam.com/charts/discovery/netherlands :param country_code: ISO 3166-3 alpha-2 code. Example: RU,NL,UA :param limit: Determines how many songs the maximum can be in the request. Example: If 5 is specified, the query will return no more than 5 songs. :param offset: A parameter that determines with which song to display the request. The default is 0. If you want to skip the first few songs, set this parameter to your own. :param proxy: Proxy server :return: dict songs )countryNr@rBr!r"rZr;r<rC) r5get_country_playlistrr#rFrrGrHr!r"rD)r6rZr;r<r=country_playlist_ids r8top_country_trackszShazam.top_country_trackss(%)$4$I$I --%J% %       %--   ) 0 0/!%!6) 1  LLNN.         r9 city_namec *K|jt||d{V}|jdt j||j|j |||| |d{VS)a$ Retrieving information from an artist profile https://www.shazam.com/charts/top-50/russia/moscow :param country_code: ISO 3166-3 alpha-2 code. Example: RU,NL,UA :param city_name: City name from https://github.com/dotX12/dotX12/blob/main/city.json Example: Budapest, Moscow :param limit: Determines how many songs the maximum can be in the request. Example: If 5 is specified, the query will return no more than 5 songs. :param offset: A parameter that determines with which song to display the request. The default is 0. If you want to skip the first few songs, set this parameter to your own. :param proxy: Proxy server :return: dict songs )r\cityNr@r]rC) r5get_city_playlistrr#rFrrGrHr!r"rD)r6rZrar;r<r=city_playlist_ids r8top_city_trackszShazam.top_city_trackss0"&!1!C!C --"D" "        %--   ) 0 0,!%!6) 1  LLNN.         r9dgenrec TKt|trt|}|j|d{V}|jdtj ||j |j ||| |d{VS)a Get world tracks by certain genre https://www.shazam.com/charts/genre/world/rock :param genre: Genre urlName from https://www.shazam.com/services/charts/locations :param limit: Determines how many songs the maximum can be in the request. Example: If 5 is specified, the query will return no more than 5 songs. :param offset: A parameter that determines with which song to display the request. The default is 0. If you want to skip the first few songs, set this parameter to your own. :param proxy: Proxy server :return: dict songs )rhNr@rArC) isinstancestrrr5 get_genrer#rFrrGrHr!r"rD)r6rhr;r<r=genre_playlist_ids r8top_world_genre_trackszShazam.top_world_genre_trackss* eS ! ! &u%%E"&"2"<"<5"<"I"IIIIIII%--   ) 0 0-!%!6 1  LLNN.         r9c rKt|trt|}|jt ||d{V}|jdtj ||j |j |||| |d{VS)a9 The best tracks by a genre in the country https://www.shazam.com/charts/genre/spain/hip-hop-rap :param country_code: ISO 3166-3 alpha-2 code. Example: RU,NL,UA :param genre: Genre name or ID: POP = 1, HIP_HOP_RAP = 2, DANCE = 3, ELECTRONIC = 4, RNB_SOUL = 5, ALTERNATIVE = 6, ROCK = 7 LATIN = 8, FILM_TV_STAGE = 9, COUNTRY = 10, AFRO_BEATS = 11, WORLDWIDE = 12, REGGAE_DANCE_HALL = 13 HOUSE = 14, K_POP = 15, FRENCH_POP = 16, SINGER_SONGWRITER = 17, REGIONAL_MEXICANO = 18 :param limit: Determines how many songs the maximum can be in the request. Example: If 5 is specified, the query will return no more than 5 songs :param offset: A parameter that determines with which song to display the request. The default is 0. If you want to skip the first few songs, set this parameter to your own. :param proxy: Proxy server :return: dict songs )r\rhNr@r]rC)rjrkrr5get_genre_from_countryrr#rFrrGrHr!r"rD)r6rZrhr;r<r=rms r8top_country_genre_trackszShazam.top_country_genre_trackss6 eS ! ! &u%%E"&"2"I"I --#J# #        %--   ) 0 0-!%!6) 1  LLNN.         r9r'c K|jdtj|j|j|||||d{VS)a Similar songs based song id https://www.shazam.com/track/546891609/2-phu%CC%81t-ho%CC%9Bn-kaiz-remix :param track_id: Track number. Example: (549952578) https://www.shazam.com/track/549952578/ :param limit: Determines how many songs the maximum can be in the request. Example: If 5 is specified, the query will return no more than 5 songs :param offset: A parameter that determines with which song to display the request. The default is 0. If you want to skip the first few songs, set this parameter to your own. :param proxy: Proxy server :return: dict tracks r@)r!r"r;r<rUrCN)r#rFr RELATED_SONGSrHr!r"rD)r6rUr;r<r=s r8related_trackszShazam.related_tracks8s(%--   # * *!%!6! +  LLNN.         r9c K|jdtj|j|j|||||d{VS)aG Search all artists by prefix or fullname :param query: Artist name or search prefix :param limit: Determines how many artists the maximum can be in the request. Example: If 5 is specified, the query will return no more than 5 artists. :param offset: A parameter that determines with which song to display the request. The default is 0. If you want to skip the first few songs, set this parameter to your own. :param proxy: Proxy server :return: dict artists r@r!r"r;r<rLrCN)r#rFr SEARCH_ARTISTrHr!r"rDr6rLr;r<r=s r8 search_artistzShazam.search_artistYs$%--   # * *!%!6 +  LLNN.         r9c K|jdtj|j|j|||||d{VS)a8 Search all tracks by prefix :param query: Track full title or prefix title :param limit: Determines how many songs the maximum can be in the request. Example: If 5 is specified, the query will return no more than 5 songs. :param offset: A parameter that determines with which song to display the request. The default is 0. If you want to skip the first few songs, set this parameter to your own. :param proxy: Proxy server :return: dict songs r@rvrCN)r#rFr SEARCH_MUSICrHr!r"rDrxs r8 search_trackzShazam.search_trackxs$%--   " ) )!%!6 *  LLNN.         r9cK|jdtj||j||d{VS)a* Returns the total track listener counter. :param track_id: Track number. Example: (559284007) https://www.shazam.com/track/559284007/rampampam :param proxy: Proxy server :return: The data dictionary that contains the listen counter. r@r&rCN)r#rFrLISTENING_COUNTERrHr!rDrXs r8listening_counterzShazam.listening_counters|%--   ' . . /  LLNN.         r9 track_idscK|jdtjd|i||d{VS)a5 Returns the total track listener counter. :param track_ids: Track numbers (list). Example: ([559284007]) https://www.shazam.com/track/559284007/rampampam :param proxy: Proxy server :return: The data dictionary that contains the listen counter. r@idrON)r#rFrLISTENING_COUNTER_MANYrD)r6rr=s r8listening_counter_manyzShazam.listening_counter_manyse%--   ,)$LLNN .         r9c K|jdtj|j|||||d{VS)a8 Get all albums of a specific artist :param artist_id: Artist number. Example (203347991) :param limit: Determines how many songs the maximum can be in the request. Example: If 5 is specified, the query will return no more than 5 songs. :param offset: A parameter that determines with which song to display the request. The default is 0. If you want to skip the first few songs, set this parameter to your own. :param proxy: Proxy server :return: dict albums r@)r"r;r<rKrCN)r#rFr ARTIST_ALBUMSrHr"rD)r6rKr;r<r=s r8 artist_albumszShazam.artist_albumss(%--   # * *!%!6# +   LLNN.         r9album_idcK|jdtj|j|||d{VS)z Get album info by id :param album_id: Album number. Example (203347991) :param proxy: Proxy server :return: dict albums r@)r"rrCN)r#rFrARTIST_ALBUM_INFOrHr"rD)r6rr=s r8 search_albumzShazam.search_albums}%--   ' . .!%!6! /  LLNN.         r9linkcrK|jd|||d{VS)Nr@rC)r#rFrD)r6rr=s r8get_youtube_datazShazam.get_youtube_datasZ %--  LLNN .         r9z.Use recognize method instead of recognize_songdatacKt|d{V}tj|}tj|}|}|dgiS|||d{VS)a Creating a song signature based on a file and searching for this signature in the shazam database. :param data: Path to song file or bytes :param proxy: Proxy server :return: Dictionary with information about the found song )rNmatches)r=)rrnormalize_audio_datacreate_signature_generatorget_next_signaturesend_recognize_request)r6rr=songaudiosignature_generator signatures r8recognize_songzShazam.recognize_songs4(((((((((.t44'B5II'::<<  r? "00 1         r9sigc Ktjtj|t |j|jz dzt tjdz}|j dtj |jtjj|jt't)jt't)j|||d{VS)NiPOSTr!devicer"uuid_1uuid_2rDr=json)r data_searchr TIME_ZONE encode_to_uriintnumber_samplessample_rate_hztimer#rFrSEARCH_FROM_FILErHr!rrandomvaluer"rkuuiduuid4upperrDr6rr=rs r8rzShazam.send_recognize_requests" $        "S%77$> ? ?  d" # #    %--   & - -},!%!64:<<((..004:<<((..00 .  LLNN.         r9optionscdKt|ttjfr#|j||d{V}nNt|t tfr#|j||d{V}ntd| ||d{VS)a All logic and mathematics are transferred to RUST lang. Creating a song signature based on a file and searching for this signature in the shazam database. :param data: Path to song file or bytes :param proxy: Proxy server :param options: Search parameters :return: Dictionary with information about the found song )rrNzInvalid data type)rr=) rjrkpathlibPathr4recognize_pathbytes bytearrayrecognize_bytes ValueErrorsend_recognize_request_v2)r6rr=rrs r8 recognizezShazam.recognize8s dS',/ 0 0 2"2AAV]A^^^^^^^^II ui0 1 1 2"2BBW^B________II011 133 3OOOOOOOOOr9c ,Ktjtj|jj|jj|j}|j dtj |j tjj|jt%t'jt%t'j|||d{VS)Nrrr)rrrrrurisamples timestampr#rFrrrHr!rrrr"rkrrrrDrs r8rz Shazam.send_recognize_request_v2Qs $   M  M ! M    %--   & - -},!%!64:<<((..004:<<((..00 .  LLNN.         r9)rrNr )r:rN)NN)N)rgrN)r'rN)r rN),__name__ __module__ __qualname____doc__rkrrrr3rrrJrrTrYr`rfrrrnrqrtryr|rrrrrrrrrrrr rrrr rr r __classcell__)r7s@r8rrs $59(* 888812 8 #& 8888884#     }  c3h     F(,#     $ }  c3h     H $   }  c3h     6# $ $ $ $  $ } $ c3h $ $ $ $ T# ) ) ) )  )  ) } )  c3h) ) ) ) \# $ $ Z_%$ $  $ } $ c3h $ $ $ $ T# / / / Z_%/  /  / } /  c3h/ / / / h#       }  c3h     H#       }  c3h     D#       }  c3h     D $   }  c3h     4 $  9 }  d38n      .#       }     F $   }    4 $     }   c3h     Z@AA $  CuiEF }  c3h    BA 8 $   }  c3h     8 $*. PPC )*P}P,' P c3h PPPP8 $   }  c3h         r9r)*rrrtypingrrrrr aiohttp_retryrpydubr shazamio_corer r r clientr converterrrdeprecated.decoratorrenumsrinterfaces.clientrmiscrrrschemas.artistsrrr typehintsrutilsrrrr9r8rs ))))))))))))******==========,,,,,,,,,,,,,,222222!!!!!!!!((((((%%%%%%""""""''''''O  O  O  O  O  WO  O  O  O  O  r9