https://github.com/manojkp08/gdsc_android_task_cinehub
CineHub is an Android application developed using Kotlin and XML, designed to provide users with a seamless experience in exploring and discovering TV shows and their episodes.
https://github.com/manojkp08/gdsc_android_task_cinehub
android coroutines kotlin okhttp3 retrofit2 tvmaze-api
Last synced: about 1 year ago
JSON representation
CineHub is an Android application developed using Kotlin and XML, designed to provide users with a seamless experience in exploring and discovering TV shows and their episodes.
- Host: GitHub
- URL: https://github.com/manojkp08/gdsc_android_task_cinehub
- Owner: manojkp08
- Created: 2023-12-26T08:49:27.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-12-30T15:42:32.000Z (over 2 years ago)
- Last Synced: 2025-02-03T08:58:30.377Z (over 1 year ago)
- Topics: android, coroutines, kotlin, okhttp3, retrofit2, tvmaze-api
- Language: Kotlin
- Homepage:
- Size: 6.77 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CineHub - Your Ultimate TV Show Companion
CineHub is an Android application developed using Kotlin and XML, designed to provide users with a seamless experience in exploring and discovering TV shows and their episodes. The app leverages a powerful tech stack, including OKHTTP, Retrofit, Retrofit GSON converter, Glide, Paging, Coroutines, and Room to ensure optimal performance and a feature-rich user interface.
## Features
- **TV Show List:** Browse a comprehensive list of TV shows fetched from the TVMaze API.
- **Episode Details:** View detailed information about each TV show, including the complete list of episodes.
- **Smooth User Experience:** Utilizes coroutines for asynchronous programming, ensuring a responsive and smooth user interface.
- **Efficient Data Fetching:** OKHTTP and Retrofit are employed for efficient and reliable data fetching from the TVMaze API.
- **Image Loading:** Glide is used for efficient and fast loading of images, enhancing the visual appeal of the app.
- **Pagination:** Implements Paging to manage and load large data sets efficiently, enhancing performance.
- **Local Database:** Room is utilized for local data storage, providing offline access to previously fetched data.
## Screenshots
## Tech Stack
- **Kotlin:** Primary programming language for Android app development.
- **XML:** Markup language for designing the app's user interface.
- **OKHTTP:** HTTP client for making network requests.
- **Retrofit:** Type-safe HTTP client for Android and Java.
- **Retrofit GSON Converter:** Converts JSON responses into Kotlin data classes.
- **Glide:** Image loading library for smooth and efficient image loading.
- **Coroutines:** Used for asynchronous programming, ensuring a responsive user interface.
- **Paging:** Library for managing and loading large data sets in a paginated manner.
- **Room:** Local database for storing and caching data.
## Getting Started
To run CineHub on your local machine, follow these steps:
1. Clone the repository: `git clone https://github.com/manojkp08/GDSC_Android_Task_CineHub.git`
2. Open the project in Android Studio.
3. Build and run the app on your emulator or physical device.
## Contributing
If you'd like to contribute to CineHub, please follow these guidelines:
1. Fork the repository.
2. Create a new branch: `git checkout -b feature/new-feature`
3. Make your changes and commit them: `git commit -m 'Add new feature'`
4. Push to the branch: `git push origin feature/new-feature`
5. Submit a pull request.
## Acknowledgments
- Thanks to TVMaze for providing the API that powers CineHub.
## Contact
For any inquiries or feedback, please contact [manojkpr92806@gmail.com](mailto:manojkpr92806@gmail.com).