CCloud is a modern Android streaming application built with Jetpack Compose and Kotlin. The app provides a sleek user interface for browsing movies and TV series, playing videos, and customizing the viewing experience. With a focus on user experience and performance, CCloud delivers high-quality streaming content in an intuitive and visually appealing interface.
- Browse Movies & Series: Attractive grid layout for discovering content
- Powerful Search: Search across both movies and TV series with real-time results
- Detailed Information: Comprehensive details for each movie and series including ratings, genres, and descriptions
- Custom Video Player: Built with ExoPlayer for smooth video playback
- Multiple Quality Options: Choose from various quality options for playback and download
- Download Options: Multiple download methods including browser, ADM, and VLC
- Fullscreen Experience: Optimized landscape mode for immersive viewing
- Save Content: Add movies and series to your favorites list
- Quick Access: Easily access your saved content from the Favorites screen
- Organize: Remove items from favorites with individual delete options
- Bulk Actions: Clear all favorites with a single action
- Theme Customization: Light, dark, and system themes with color options
- Subtitle Settings: Customize subtitle appearance (background, text color, border, size)
- Responsive UI: Material Design 3 interface that adapts to all screen sizes
- Intuitive Navigation: Bottom navigation for mobile/tablet and sidebar navigation for TV
- Error Handling: Retry mechanisms for failed requests
- Loading States: Shimmer loading animations for smooth user experience
- Season & Episode Management: Easy navigation through TV series seasons and episodes
- Optimized Layout: Sidebar navigation for better TV experience
- Full Screen Support: Content fills the entire TV screen
- Remote Control Navigation: D-pad optimized navigation
- Cross-Platform Compatibility: Works on mobile, tablet, and TV with adaptive UI
- Kotlin - Primary programming language
- Jetpack Compose - Modern toolkit for building native UI
- ExoPlayer - Media playback library
- Kotlin Serialization - JSON serialization
- Coil - Image loading library
- Material Design 3 - UI components and design system
- Navigation Component - For seamless screen transitions
- ViewModel & LiveData - For state management
- Coroutines - For asynchronous operations
- OkHttp - For network requests
- Leanback - Android TV support library
The app follows a clean architecture pattern with the following components:
- UI Layer - Jetpack Compose screens and components
- Data Layer - Models and repositories for data management
- Domain Layer - Business logic and use cases
- Utils - Helper classes and extensions
- Navigation - Single-activity architecture with Compose Navigation
- State Management - ViewModel for UI state handling
CCloud supports Android 9.0 (API level 28) and higher. The app is optimized for:
- Android 9.0 - 16 (API levels 28-36)
- Android TV devices
- Tablets and large-screen devices
- Android 8.x and below: Not supported due to Jetpack Compose limitations
- Android 9.0+: Full feature support with optimal performance
- Android TV: Specialized UI with remote control navigation
- Android Studio Ladybug or later
- Android SDK API 36 (Android 16)
-
Clone the repository:
git clone https://github.com/code3-dev/CCloud.git
-
Open the project in Android Studio
-
Build and run the project
To build the debug APK:
./gradlew assembleDebugTo build the release APK:
./gradlew assembleReleaseIf you encounter Gradle wrapper validation errors (especially in CI/CD environments), you can fix them using the provided scripts:
On Unix/Linux/macOS:
./scripts/fix-gradle-wrapper.shOn Windows:
scripts\fix-gradle-wrapper.batYou can also verify the integrity of the Gradle wrapper:
On Unix/Linux/macOS:
./scripts/verify-gradle-wrapper.shOn Windows:
scripts\verify-gradle-wrapper.batThese scripts will regenerate the Gradle wrapper checksums which are required for validation.
app/
├── src/
│ ├── main/
│ │ ├── java/com/pira/ccloud/
│ │ │ ├── components/ # Reusable UI components
│ │ │ ├── data/ # Data layer
│ │ │ │ ├── model/ # Data models (Movie, Series, etc.)
│ │ │ │ └── repository/ # Data repositories
│ │ │ ├── navigation/ # Navigation graph and components
│ │ │ ├── screens/ # Compose screens
│ │ │ ├── ui/ # UI components and theme
│ │ │ │ ├── movies/ # Movie-specific UI components
│ │ │ │ ├── search/ # Search-specific UI components
│ │ │ │ ├── series/ # Series-specific UI components
│ │ │ │ └── theme/ # Theme definitions and management
│ │ │ ├── utils/ # Utility classes
│ │ │ ├── MainActivity.kt # Main application activity
│ │ │ └── VideoPlayerActivity.kt # Video player activity
│ │ └── res/ # Resources
│ │ ├── drawable/ # Drawable resources
│ │ ├── values/ # Default resources
│ │ ├── values-television/ # TV-specific resources
│ │ └── ... # Other resources
│ └── test/ # Unit tests
├── build.gradle.kts # App build configuration
└── ...
The app features a custom video player built with ExoPlayer that supports:
- Play/Pause controls
- Progress seeking
- Subtitle customization
- Fullscreen landscape mode
Users can customize their experience through the settings screen:
- Theme mode (Light/Dark/System)
- Primary and secondary color selection
- Subtitle settings (colors and text size)
- Browse latest movies in an attractive grid layout
- Pull-to-refresh functionality
- Infinite scrolling for loading more content
- Error handling with retry option
- Shimmer loading animations
- Browse TV series with comprehensive information
- Season and episode organization
- Pull-to-refresh and infinite scrolling
- Error handling with retry option
- View all saved movies and series in one place
- Individual item deletion
- Bulk deletion of all favorites
- Direct navigation to content details
- Visual indicators for content type and ratings
- Real-time search across movies and series
- Instant results as you type
- Error handling with retry button
- Clear search functionality
- Detailed movie information
- Multiple quality options for playback
- Download options (Browser, ADM, VLC)
- Custom video player integration
- Add/remove from favorites
- Comprehensive series details
- Season navigation and episode listing
- Multiple quality options per episode
- Download options for each episode
- Error handling with retry functionality
- Add/remove from favorites
- Theme customization (Light/Dark/System)
- Primary and secondary color selection
- Subtitle settings (colors and text size)
- Reset to default options
The app uses adaptive navigation:
- Mobile/Tablet: Bottom navigation bar for switching between screens
- TV: Sidebar navigation for better remote control experience
- D-Pad (Arrow Keys): Navigate between UI elements, scroll through lists, and move focus
- Select (OK) Button: Confirm selections, open items, play/pause media
- Back Button: Navigate to previous screen or exit the app
- Home Button: Return to the main launcher
- Use the Up/Down arrow keys to navigate between menu items in the sidebar
- Press Select (OK) to open the selected section (Movies, Series, Search, Settings)
- Use Left/Right arrow keys to navigate between items in a row
- Use Up/Down arrow keys to move between rows
- Press Select (OK) to open details for a selected movie or series
- Play/Pause: Press the Select (OK) button or Play/Pause button when focused on the player
- Seek Forward/Backward: Use the Left/Right arrow keys to skip 10 seconds
- Volume Control: Use the Up/Down arrow keys on the directional pad or volume buttons on the remote
- Exit Fullscreen: Press the Back button to exit fullscreen mode and return to the content details
When watching videos on Android TV, you can control playback using your remote control:
- Play/Pause: Press the Select (OK) button or Play/Pause media button
- Fast Forward: Press the Right Arrow key to skip forward 10 seconds
- Rewind: Press the Left Arrow key to skip backward 10 seconds
- Exit Player: Press the Back button to exit the video player and return to the content details
- Navigate to the Search section using the sidebar
- The on-screen keyboard can be controlled with the D-pad
- Up/Down/Left/Right: Move between keyboard keys
- Select (OK): Press the selected key
- Backspace: Press the back button to delete characters
- In the Settings screen, use Up/Down to navigate between cards
- For expandable sections (Theme Settings, Video Player Settings), press Select (OK) to expand/collapse
- Use Left/Right arrow keys on slider controls to adjust values
- Press Select (OK) on radio buttons and color options to select them
- For dialog-based options (Reset to Defaults, Check for Updates), press Select (OK) to open the dialog
- All settings options can be controlled using either the D-pad or mouse pad
- Navigation Chain: The focus moves in a logical order between settings cards:
- Theme Settings → Video Player Settings → About → Check for Updates → Reset to Defaults
- Access the Favorites screen through the Settings menu
- Navigate through saved items using the D-pad
- Press Select (OK) to open a saved item
- Use the context menu to remove individual items or clear all favorites
- Focus Highlighting: The currently selected item is highlighted with a border or background color
- Smooth Scrolling: Content lists support smooth scrolling with the D-pad
- Quick Access: The sidebar is always accessible for quick navigation between main sections
- Exit App: Press the Back button repeatedly until you exit the app
We welcome contributions to CCloud! Here's how you can help:
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- Create a pull request
Please ensure your code follows the existing style and includes appropriate tests.
This project is licensed under the MIT License - see the LICENSE file for details.
- ExoPlayer for media playback
- Coil for image loading
- Material Design for UI components
- Leanback for TV support
For support or inquiries, please open an issue on GitHub.
![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4){kind=small}