{"id":18771371,"url":"https://github.com/miroslavvidovic/tmdb-bash","last_synced_at":"2025-04-10T20:53:20.099Z","repository":{"id":81961447,"uuid":"70087396","full_name":"miroslavvidovic/tmdb-bash","owner":"miroslavvidovic","description":"Simple CLI application using The Movie DB","archived":false,"fork":false,"pushed_at":"2018-03-26T18:20:53.000Z","size":9,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-24T18:21:52.986Z","etag":null,"topics":["bash-script","shell-script","tmdb","tmdb-api","tmdb-movie-search"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/miroslavvidovic.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-10-05T18:26:16.000Z","updated_at":"2024-12-11T22:28:11.000Z","dependencies_parsed_at":"2023-02-28T22:45:34.321Z","dependency_job_id":null,"html_url":"https://github.com/miroslavvidovic/tmdb-bash","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miroslavvidovic%2Ftmdb-bash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miroslavvidovic%2Ftmdb-bash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miroslavvidovic%2Ftmdb-bash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miroslavvidovic%2Ftmdb-bash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/miroslavvidovic","download_url":"https://codeload.github.com/miroslavvidovic/tmdb-bash/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248297241,"owners_count":21080310,"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":["bash-script","shell-script","tmdb","tmdb-api","tmdb-movie-search"],"created_at":"2024-11-07T19:24:28.282Z","updated_at":"2025-04-10T20:53:20.059Z","avatar_url":"https://github.com/miroslavvidovic.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tmdb-bash\n\n\u003e Shell script for The Movie DB API\n\n# Movie DB CLI\n\nObtain some basic information about a movie in json format\n\n## Requirements\n\n- cURL\n- xdg-open (View the Movie Poster)\n\n```\nsudo apt-get install xdg-utils\n```\n\n- jq \n\n```\nsudo apt install jq\n```\n\n## Setup\n- Go to The Movie DB website and create an account\n- Obtain an API key by following the [instructions](https://www.themoviedb.org/faq/api)\n- Copy your API key to the correct place in the tmdb.sh script \n```shell\n    APIKEY=\"your api key\"\n```\n- Run the script\n\n\n## How to use it\n\n```\nUsage :  tmdb.sh [options] title\n\n    title        Title of the movie\n\n    Options:\n    -y     Optional year for better search results\n    -i     Display the movie poster\n    -h     Display this help message\n```\n\n## Examples\n\n- Normal Search using title\n\n```shell\ntmdb.sh \"The Mummy\"\n```\n\n- Search with year\n\n```shell\ntmdb.sh -y 2017 \"The Mummy\"    \n```\n\n```json\n    {\n        \"page\": 1,\n        \"total_results\": 1,\n        \"total_pages\": 1,\n        \"results\": [\n        {\n            \"vote_count\": 1169,\n            \"id\": 282035,\n            \"video\": false,\n            \"vote_average\": 5.3,\n            \"title\": \"The Mummy\",\n            \"popularity\": 33.808368,\n            \"poster_path\": \"/zxkY8byBnCsXodEYpK8tmwEGXBI.jpg\",\n            \"original_language\": \"en\",\n            \"original_title\": \"The Mummy\",\n            \"genre_ids\": [\n                28,\n                12,\n                14,\n                27,\n                53\n            ],\n            \"backdrop_path\": \"/qedJJ2z9oBYKxxO4Pp8qAkfgPst.jpg\",\n            \"adult\": false,\n            \"overview\": \"Though safely entombed in a crypt deep beneath the unforgiving desert, an ancient queen whose destiny was unjustly taken from he is awakened in our current day, bringing with her malevolence grown over millennia, and terrors that defy human comprehension.\",\n            \"release_date\": \"2017-06-06\"\n        }\n        ]\n    }\n```\n\n- Open Movie Poster on Browser\n\n```shell\ntmdb.sh -i \"The Mummy\"\n```\n\n## The Movie DB CLI for Android Using Termux\n\n- Download Termux Android Emulator from Google Playstore\n- put `tmdb.sh` file in any location on your Android device (Don't forget to add your themoviedb API in the Bash File)\n- open the file location via Termux (Give Storage Permission for Termux - https://termux.com/storage.html)\n- it requires cURL \u0026 jq pack \n\n```\npkg install curl\n````\n\n```\npkg install jq\n```\n\n## License\n\nMIT License\n\nCopyright (c) 2016 Miroslav Vidović\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiroslavvidovic%2Ftmdb-bash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmiroslavvidovic%2Ftmdb-bash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiroslavvidovic%2Ftmdb-bash/lists"}