3 // Given a track, attempts to fetch the lyrics from lyricswiki
6 private let clientToken = <GENIUS_CLIENT_TOKEN>
8 // URL of the API endpoint to use
9 private let apiURL = "https://api.genius.com/search"
11 // Method used to call the API
12 private let apiMethod = "GET"
14 // Regular expxression used to find the lyrics in the lyricswiki HTML
15 private let lyricsMatcher = "class='lyricbox'>(.+)<div"
17 // The track we'll be looking for
18 private let track: Track
20 // Fetches the lyrics and returns if found
25 // Encode the track artist and name and finish building the API call URL
27 if let artist = track.artist.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) {
28 if let name: String = track.name.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) {
29 if let url = URL(string: "\(apiURL)&q=\(artist) \(name)") {
31 // We'll lock until the async call is finished
33 var requestFinished = false
34 let asyncLock = NSCondition()
37 // Call the API and unlock when you're done
39 searchLyricsUsingAPI(withURL: url, completionHandler: {lyricsResult -> Void in
41 requestFinished = true
45 while !requestFinished {
56 // Initializes with a track
57 init(withTrack targetTrack: Track) {
62 // Fetch the lyrics URL from the API, triggers the request to fetch the
64 private func searchLyricsUsingAPI(withURL url: URL, completionHandler: @escaping (String?) -> Void) {
66 var apiRequest = URLRequest(url: url)
67 apiRequest.httpMethod = "GET"
69 let task = URLSession.shared.dataTask(with: apiRequest, completionHandler: {data, _, _ -> Void in
71 // If the response is parseable JSON, and has a url, we'll look for
72 // the lyrics in there
75 if let jsonResponse = try? JSONSerialization.jsonObject(with: data) {
76 if let jsonResponse = jsonResponse as? [String: Any] {
77 if let hits = jsonResponse["hits"] as? [Any] {
78 if let firstHit = hits[0] as? [String: Any] {
79 if let firstHitData = firstHit["result"] as? [String: Any] {
80 if let lyricsUrlString = firstHitData["url"] as? String {
81 if let lyricsUrl = URL(string: lyricsUrlString) {
83 // At this point we have a valid wiki url
84 self.fetchLyricsFromPage(
86 completionHandler: completionHandler
98 completionHandler(nil)
103 // Fetch the lyrics from the page and send it to the parser
104 private func fetchLyricsFromPage(withURL url: URL, completionHandler: @escaping (String?) -> Void) {
106 var pageRequest = URLRequest(url: url)
107 pageRequest.httpMethod = "GET"
109 let task = URLSession.shared.dataTask(with: pageRequest, completionHandler: {data, _, _ -> Void in
111 // If the response is parseable JSON, and has a url, we'll look for
112 // the lyrics in there
115 if let htmlBody = String(data: data, encoding: String.Encoding.utf8) {
116 self.parseHtmlBody(htmlBody, completionHandler: completionHandler)
121 completionHandler(nil)
126 // Parses the wiki to find the lyrics, decodes the lyrics object
127 private func parseHtmlBody(_ body: String, completionHandler: @escaping (String?) -> Void) {
129 // Look for the lyrics lightbox
131 if let regex = try? NSRegularExpression(pattern: lyricsMatcher) {
132 let matches = regex.matches(in: body, range: NSRange(location: 0, length: body.count))
134 for match in matches {
136 let nsBody = body as NSString
137 let range = match.range(at: 1)
138 let encodedLyrics = nsBody.substring(with: range)
140 let decodedLyrics = decodeLyrics(encodedLyrics)
142 completionHandler(decodedLyrics)
147 completionHandler(nil)
150 // Escapes the HTML entities and HTML
151 private func decodeLyrics(_ lyrics: String) -> String {