{"id":51349129,"url":"https://github.com/rakin406/ranking-rangers","last_synced_at":"2026-07-02T14:45:57.539Z","repository":{"id":358406573,"uuid":"1226237428","full_name":"rakin406/ranking-rangers","owner":"rakin406","description":"Java university project","archived":false,"fork":false,"pushed_at":"2026-05-19T06:27:31.000Z","size":1081,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-02T14:45:56.864Z","etag":null,"topics":["college","java","project","university","university-project"],"latest_commit_sha":null,"homepage":"","language":"Java","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/rakin406.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-01T06:14:30.000Z","updated_at":"2026-05-19T06:27:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/rakin406/ranking-rangers","commit_stats":null,"previous_names":["rakin406/ranking-rangers"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rakin406/ranking-rangers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rakin406%2Franking-rangers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rakin406%2Franking-rangers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rakin406%2Franking-rangers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rakin406%2Franking-rangers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rakin406","download_url":"https://codeload.github.com/rakin406/ranking-rangers/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rakin406%2Franking-rangers/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35051884,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-02T02:00:06.368Z","response_time":173,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["college","java","project","university","university-project"],"created_at":"2026-07-02T14:45:54.564Z","updated_at":"2026-07-02T14:45:57.522Z","avatar_url":"https://github.com/rakin406.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎬 Ranking Rangers\n\nA Java Swing desktop application for discovering popular movies, reading their descriptions, and managing a personal watchlist — all with a secure login system.\n\n---\n\n## Features\n\n- **Popular Movies Feed** — Browse a curated list of trending and top-rated movies pulled live from The Movie Database (TMDB) API.\n- **Movie Details** — View detailed descriptions, ratings, and metadata for each movie.\n- **Bookmarks** — Save your favourite movies to a personal bookmark list for quick access later.\n- **User Authentication** — Register and log in with a personal account to keep your bookmarks tied to your profile.\n- **Modern UI** — Built with FlatLaf for a clean, modern look and feel on top of Java Swing.\n\n---\n\n## Tech Stack\n\n| Layer | Technology |\n|---|---|\n| Language | Java |\n| UI Framework | Java Swing + [FlatLaf](https://www.formdev.com/flatlaf/) 3.7.1 |\n| Movie Data | [themoviedbapi](https://github.com/c-eg/themoviedbapi) 2.6.0 |\n| Environment Config | [dotenv-java](https://github.com/cdimascio/dotenv-java) 3.2.0 |\n| Build Tool | Apache Maven |\n\n---\n\n## Prerequisites\n\n- Java 11 or higher\n- Maven 3.6+\n- A free [TMDB API](https://www.themoviedb.org/settings/api) account and access token\n\n---\n\n## Getting Started\n\n### 1. Clone the repository\n\n```bash\ngit clone https://github.com/rakin406/ranking-rangers.git\ncd ranking-rangers\n```\n\n### 2. Set up environment variables\n\nCopy the example env file and fill in your TMDB access token:\n\n```bash\ncp .env.example .env\n```\n\nOpen `.env` and replace the placeholder:\n\n```env\nTMDB_ACCESS_TOKEN=your-tmdb-access-token\n```\n\nYou can obtain a free access token from the [TMDB API settings page](https://www.themoviedb.org/settings/api).\n\n### 3. Build the project\n\n```bash\nmvn package\n```\n\nThis produces a self-contained JAR in the `target/` directory.\n\n### 4. Run the application\n\n```bash\njava -jar target/ranking-rangers-1.0-SNAPSHOT-jar-with-dependencies.jar\n```\n\n---\n\n## Usage\n\n1. **Register / Log In** — Create an account or sign in with existing credentials on the login screen.\n2. **Browse Movies** — The home screen displays a list of currently popular movies fetched from TMDB.\n3. **View Details** — Click on any movie to see its full description, release date, and rating.\n4. **Bookmark** — Hit the bookmark button on any movie card to save it to your personal list.\n5. **View Bookmarks** — Access all your saved movies from the bookmarks section.\n\n---\n\n## Project Structure\n\n```\nranking-rangers/\n├── src/\n│   └── main/\n│       └── java/\n│           └── com/rangers/app/   # Application source code\n├── .env.example                 # Environment variable template\n├── pom.xml                      # Maven build configuration\n└── README.md\n```\n\n---\n\n## License\n\nThis project was developed as a university project. Feel free to use it as a reference or learning resource.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frakin406%2Franking-rangers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frakin406%2Franking-rangers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frakin406%2Franking-rangers/lists"}