{"id":13994520,"url":"https://github.com/nomad-cli/nashville","last_synced_at":"2025-07-22T19:32:34.472Z","repository":{"id":13458489,"uuid":"16148159","full_name":"nomad-cli/nashville","owner":"nomad-cli","description":"A wrapper and command line interface for querying the iTunes Store API","archived":true,"fork":false,"pushed_at":"2021-06-20T11:08:24.000Z","size":17,"stargazers_count":173,"open_issues_count":0,"forks_count":8,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-07-13T08:48:05.097Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nomad-cli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-01-22T18:28:28.000Z","updated_at":"2025-02-18T13:15:40.000Z","dependencies_parsed_at":"2022-09-13T18:21:52.225Z","dependency_job_id":null,"html_url":"https://github.com/nomad-cli/nashville","commit_stats":null,"previous_names":["nomad/nashville"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/nomad-cli/nashville","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nomad-cli%2Fnashville","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nomad-cli%2Fnashville/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nomad-cli%2Fnashville/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nomad-cli%2Fnashville/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nomad-cli","download_url":"https://codeload.github.com/nomad-cli/nashville/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nomad-cli%2Fnashville/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265121415,"owners_count":23714505,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-09T14:02:55.045Z","updated_at":"2025-07-22T19:32:34.136Z","avatar_url":"https://github.com/nomad-cli.png","language":"Ruby","readme":"# Nashville\n\n\u003e **Note**: This project is no longer being maintained.\n\nNashville is a wrapper and command line interface for querying the [iTunes Store API](http://www.apple.com/itunes/affiliates/resources/documentation/itunes-store-web-service-search-api.html).\n\n\u003e Nashville is named after the [eponymous Capital of Country Music (and Tennesee)](http://en.wikipedia.org/wiki/Nashville,_Tennessee), home of [the Grand 'Ole Opry](http://en.wikipedia.org/wiki/Grand_Ole_Opry) and the [Country Music Hall of Fame and Museum](http://en.wikipedia.org/wiki/Country_Music_Hall_of_Fame_and_Museum).\n\n## Installation\n\n    $ gem install nashville\n\n## Usage\n\n```ruby\nrequire 'nashville'\n\nNashville::Movie.search(director: \"Wes Anderson\")\n\nNashville::Music::Artist.search(artist: \"Miles Davis\", limit: 5)\n```\n\n\u003e For more information about parameters and general usage, check out [Apple's documentation for the iTunes Affiliate Search API](http://www.apple.com/itunes/affiliates/resources/documentation/itunes-store-web-service-search-api.html).\n\n## Command Line Interface\n\nNashville also comes with the `its` binary, which allows you to query the iTunes Store from the command line:\n\n    $ its search --help\n\n    Usage: its search QUERY\n\n      Examples:\n\n        # search\n        its search \"Jamiroquai\"\n\n      Options:\n        -m, --media MEDIA    The media type to search for\n        -e, --entity ENTITY  The type of results to be returned, relative to the specified media type.\n        -a, --attribute ATTRIBUTE The attribute to be searched for in the stores, relative to the specified media type.\n\n        --limit LIMIT        The maximum number of results to return.\n        --language LANGUAGE  The language, English or Japanese, to use when returning search results.\n        -p, --secret SECRET  Use a shared secret for auto-renewable subscription receipts\n        -X, --[no-]explicit  Include explicit content in search results.\n\n\n    $ its search \"Blue in Green\" --media music --entity song\n\n    50 Results\n\n    +------------------------+---------------------------------------------------------------------------------+\n    |                                                 Result 1                                                 |\n    +------------------------+---------------------------------------------------------------------------------+\n    | artistId               | 44984                                                                           |\n    | artistName             | Miles Davis                                                                     |\n    | artistViewUrl          | https://itunes.apple.com/us/artist/miles-davis/id44984?uo=4                     |\n    | artworkUrl100          | http://a3.mzstatic.com/us/r30/Music/75/d7/9e/mzi.tugmofjx.100x100-75.jpg        |\n    | artworkUrl30           | http://a3.mzstatic.com/us/r30/Music/75/d7/9e/mzi.tugmofjx.30x30-50.jpg          |\n    | artworkUrl60           | http://a2.mzstatic.com/us/r30/Music/75/d7/9e/mzi.tugmofjx.60x60-50.jpg          |\n    | collectionCensoredName | Kind of Blue                                                                    |\n    | collectionExplicitness | notExplicit                                                                     |\n    | collectionId           | 162322551                                                                       |\n    | collectionName         | Kind of Blue                                                                    |\n    | collectionPrice        | 9.99                                                                            |\n    | collectionViewUrl      | https://itunes.apple.com/us/album/blue-in-green/id162322551?i=162322872\u0026uo=4    |\n    | country                | USA                                                                             |\n    | currency               | USD                                                                             |\n    | discCount              | 1                                                                               |\n    | discNumber             | 1                                                                               |\n    | kind                   | song                                                                            |\n    | previewUrl             | http://a456.phobos.apple.com/us/r1000/090/Music/ca/55/73/mzm.yslzuywm.aac.p.m4a |\n    | primaryGenreName       | Jazz                                                                            |\n    | radioStationUrl        | https://itunes.apple.com/us/station/idra.162322872                              |\n    | releaseDate            | 1997-03-04T08:00:00Z                                                            |\n    | trackCensoredName      | Blue In Green                                                                   |\n    | trackCount             | 6                                                                               |\n    | trackExplicitness      | notExplicit                                                                     |\n    | trackId                | 162322872                                                                       |\n    | trackName              | Blue In Green                                                                   |\n    | trackNumber            | 3                                                                               |\n    | trackPrice             | 0.99                                                                            |\n    | trackTimeMillis        | 337560                                                                          |\n    | trackViewUrl           | https://itunes.apple.com/us/album/blue-in-green/id162322551?i=162322872\u0026uo=4    |\n    | wrapperType            | track                                                                           |\n    +------------------------+---------------------------------------------------------------------------------+\n\n    ...\n\n\n## License\n\nNashville is available under the MIT license. See the LICENSE file for more info.\n","funding_links":[],"categories":["Ruby"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnomad-cli%2Fnashville","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnomad-cli%2Fnashville","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnomad-cli%2Fnashville/lists"}