{"id":23378026,"url":"https://github.com/letsmakecakes/tmdb-cli","last_synced_at":"2026-04-28T18:34:12.662Z","repository":{"id":266304087,"uuid":"895080452","full_name":"letsmakecakes/tmdb-cli","owner":"letsmakecakes","description":"A command-line tool built in Go that fetches and displays movie information from The Movie Database (TMDB) API. Get quick access to popular, top-rated, upcoming, and now playing movies directly in your terminal.","archived":false,"fork":false,"pushed_at":"2025-01-05T15:56:22.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-14T03:35:52.959Z","etag":null,"topics":["api-client","api-wrapper","cli","cli-app","command-line","go","golang","terminal","tmdb","tmdb-api"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/letsmakecakes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-11-27T14:23:01.000Z","updated_at":"2025-01-05T15:58:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"0f18c898-1ed7-454b-871f-6cfa3ef0bba9","html_url":"https://github.com/letsmakecakes/tmdb-cli","commit_stats":null,"previous_names":["letsmakecakes/tmdb-cli"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letsmakecakes%2Ftmdb-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letsmakecakes%2Ftmdb-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letsmakecakes%2Ftmdb-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letsmakecakes%2Ftmdb-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/letsmakecakes","download_url":"https://codeload.github.com/letsmakecakes/tmdb-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247779763,"owners_count":20994572,"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":["api-client","api-wrapper","cli","cli-app","command-line","go","golang","terminal","tmdb","tmdb-api"],"created_at":"2024-12-21T18:34:06.240Z","updated_at":"2026-04-28T18:34:07.642Z","avatar_url":"https://github.com/letsmakecakes.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TMDB CLI Tool\n\nA command-line interface (CLI) tool built in Go that fetches and displays movie information from The Movie Database (TMDB) API. Get quick access to popular, top-rated, upcoming, and now playing movies right from your terminal.\n\n## 🎯 Features\n\n- Fetch different categories of movies:\n    - Now Playing\n    - Popular Movies\n    - Top Rated Movies\n    - Upcoming Movies\n- Clean terminal output with formatted movie details\n- Error handling for API and network issues\n- Configurable via environment variables\n- Simple and intuitive command-line interface\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Go 1.16 or higher\n- TMDB Bearer Token ([Get it here](https://www.themoviedb.org/settings/api))\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/yourusername/tmdb-app.git\ncd tmdb-app\n```\n\n2. Set up your TMDB Bearer Token:\n```bash\nexport TMDB_BEARER_TOKEN='your-bearer-token-here'\n```\n\n3. Build the application:\n```bash\nmake build\n```\n\n### Usage\n\nThe CLI tool supports the following commands:\n\n```bash\n# Get now playing movies\n./bin/tmdb-app --type \"playing\"\n\n# Get popular movies\n./bin/tmdb-app --type \"popular\"\n\n# Get top rated movies\n./bin/tmdb-app --type \"top\"\n\n# Get upcoming movies\n./bin/tmdb-app --type \"upcoming\"\n```\n\n## 📁 Project Structure\n\n```\n.\n├── cmd/\n│   └── tmdb-app/\n│       └── main.go\n├── internal/\n│   ├── api/\n│   │   ├── client.go\n│   │   └── models.go\n│   ├── config/\n│   │   └── config.go\n│   └── cli/\n│       └── app.go\n├── pkg/\n│   └── formatter/\n│       └── formatter.go\n├── go.mod\n├── Makefile\n└── README.md\n```\n\n### Directory Overview\n\n- `cmd/`: Contains the main application entry points\n- `internal/`: Private application code\n    - `api/`: TMDB API client and data models\n    - `config/`: Configuration management\n    - `cli/`: CLI application logic\n- `pkg/`: Public packages that can be used by external applications\n    - `formatter/`: Output formatting utilities\n\n## 🛠️ Development\n\n### Building\n\n```bash\n# Build the application\nmake build\n\n# Run tests\nmake test\n\n# Run the application directly\nmake run\n```\n\n### Adding New Features\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📝 Example Output\n\n```\nMovie List:\n====================================\n\nTitle: Gladiator II (2024-11-05)\nRating: 6.8/10 (1979 votes)\nPopularity: 4782.6\n\nOverview:\nYears after witnessing the death of the revered hero Maximus...\n------------------------------------\n\nTitle: Your Fault (2024-12-26)\nRating: 7.1/10 (641 votes)\nPopularity: 4279.1\n\nOverview:\nThe love between Noah and Nick seems unwavering...\n------------------------------------\n\nTotal movies shown: 20\n```\n\n## 🔧 Configuration\n\nThe application uses environment variables for configuration:\n\n| Variable | Description | Required |\n|----------|-------------|----------|\n| TMDB_BEARER_TOKEN | Your TMDB API Bearer Token | Yes |\n\n## ⚠️ Error Handling\n\nThe application handles various error cases:\n- Invalid movie types\n- API authentication failures\n- Network connectivity issues\n- Rate limiting\n- Invalid responses\n\n## 📚 API Documentation\n\nThis project uses the TMDB API v3. For more information about the API, visit:\n- [TMDB API Documentation](https://developers.themoviedb.org/3)\n- [Authentication](https://developers.themoviedb.org/3/authentication)\n- [Movie Endpoints](https://developers.themoviedb.org/3/movies)\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- [The Movie Database (TMDB)](https://www.themoviedb.org/) for providing the API\n- The Go community for the amazing tooling and libraries\n\n## 📧 Contact\n\nYour Name - [@letsmakecakes_](https://twitter.com/letsmakecakes_)\n\nProject Link: [https://github.com/letsmakecakes/tmdb-cli](https://github.com/letsmakecakes/tmdb-cli)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fletsmakecakes%2Ftmdb-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fletsmakecakes%2Ftmdb-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fletsmakecakes%2Ftmdb-cli/lists"}