Skip to content

Releases: 0-kodiya-0/FilmFinder

v1.0.0

20 May 14:43
@0-kodiya-0 0-kodiya-0
v1.0.0
ccea25e

Choose a tag to compare

View all tags
v1.0.0 Latest
Latest

FilmFinder v1.0 Release Notes

Overview

FilmFinder is a modern Android application built with Jetpack Compose and Material 3 that allows users to search for and discover movies using the OMDb API (Open Movie Database). Following the MVVM architecture pattern, FilmFinder provides an intuitive user interface for exploring film information with both online and offline capabilities.

Features

Core Functionality

  • Movie Search: Search for movies by title with detailed information display including plot, cast, ratings, and poster images
  • Actor-based Search: Find movies featuring specific actors from the local database
  • Extended Movie Search: Search with advanced filtering options and pagination support to browse large result sets
  • Offline Database: Pre-populated with classic movies and ability to save search results for offline viewing
  • Responsive UI: Optimized layouts for both portrait and landscape orientations

Search Capabilities

  • Simple Search: Quick search by movie title with basic information
  • Detailed Search: Extended search with multiple filter options:
    • Year filtering
    • Rating inclusion
    • Search result pagination (when multiple matches are found)
  • Actor-based Filtering: Find movies by actor name with additional filtering by:
    • Genre
    • Year range (from/to)
    • High rating threshold (IMDb rating ≥ 7.0)

User Interface

  • Material 3 Design: Modern UI following latest Material Design guidelines
  • Theme Support: Full dark mode/light mode support with custom color scheme
  • Responsive Layouts: Different layouts for portrait and landscape orientations
  • Cached Images: Efficient image loading and caching system to improve performance and reduce network usage
  • Loading Indicators: Visual feedback during network operations
  • Error Handling: User-friendly error messages with retry options
  • Snackbar Notifications: Temporary feedback messages for user actions

Technical Features

  • Image Caching: Custom ImageCacheManager that efficiently manages memory usage
  • Network Connectivity Monitoring: Real-time network state detection with appropriate UI feedback
  • Room Database Integration: Local storage with type converters for complex data structures
  • Coroutines & Flow: Modern asynchronous programming for smooth UI experience
  • MVVM Architecture: Clean separation of concerns with ViewModels for business logic
  • Screen-specific Image Caching: Memory-efficient image handling that clears cache when leaving screens

Missing Features and Limitations

  • User Accounts: No user registration or authentication system
  • Favorites/Watchlist: No ability to mark movies as favorites or add to a watchlist
  • Recommendations: No personalized movie recommendations
  • Video Playback: No trailer or video content playback
  • Social Features: No sharing capabilities or social media integration
  • Advanced Search: No search by crew members other than actors (e.g., directors, writers)
  • Reviews: No user reviews or community content
  • Movie Categories/Collections: No curated collections or category browsing
  • Release Notifications: No alerts for upcoming movies
  • Offline Search: Search functionality requires an internet connection

Known Issues and Downsides

API Limitations

  • Data Source Dependency: Completely dependent on OMDb API for movie data
  • Rate Limiting: OMDb API has request limits which could affect heavy usage
  • API Key Exposure: API key is stored in the code rather than secured in a backend
  • No Real-time Updates: Data may not reflect the very latest movie information

Technical Considerations

  • Memory Usage: Image caching can consume significant memory on devices with limited RAM
  • Network Performance: Search operations require good network connectivity
  • Database Size: Saving many movies locally can increase app storage usage
  • Limited Content: Only movie information available, no TV shows or other media types
  • HTTP (not HTTPS): Some image URLs from OMDb API may use non-secure HTTP

User Experience

  • No Content Filtering: No parental controls or content rating filtering
  • Limited Offline Functionality: Most features require internet connectivity
  • Simple UI: Interface prioritizes functionality over advanced animations
  • Fixed Language: No internationalization or language switching options
  • No Backup: No cloud backup for saved movies

Future Development Roadmap

While not included in this release, we're considering the following features for future updates:

  • User accounts and personalization
  • Watchlist and favorites functionality
  • More advanced search options
  • Review system integration
  • Movie recommendations
  • Social media sharing
  • Improved offline capabilities
  • Additional media types (TV shows, documentaries)

Technical Requirements

  • Minimum Android SDK: 24 (Android 7.0 Nougat)
  • Target Android SDK: 35 (Android 15)
  • Java Compatibility: Java 11
  • Kotlin Version: 2.0.21

Contributors

  • Sanithu Jayakody

License

This application is released under the MIT License.

Full Changelog: https://github.com/0-kodiya-0/FilmFinder/commits/v1.0.0

Assets 3
Loading