/filmer

🦖 Filmer is an intuitive and feature-rich application for movie enthusiasts.

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

Girl in a jacket

Filmer is an intuitive and feature-rich application for movie enthusiasts. Powered by The Movie Database (TMDB) API, it offers a seamless experience for exploring, tracking, and organizing your favorite movies. Whether you're looking to dive into a new film or keep track of your movie-watching journey, Filmer is the perfect companion for every cinema lover

Features

  • Discover: Get instant access to the latest and most popular movies.Explore new genres, trending movies, and more.
  • Lists: Keep track of the movies you've already watched or the movies that you will watch by adding them to your personalized lists.
  • Search: Find any movie in a snap.
  • Intuitive UI: A user-friendly interface that makes navigation and managing your movie lists a breeze.

Getting Started

Prerequisites

Before you begin, ensure you have the following:

  • A working development environment for Android/iOS (depending on your target platform).
  • Access to TMDB API (you'll need your own API key).

Installation

  1. Clone the Repository:

    git clone https://github.com/dybdeskarphet/filmer.git
cd filmer

  2. Install Dependencies:

    # For npm
npm install

# For Yarn
yarn install

  3. API Key Configuration:

    • Obtain your TMDB API Key.
    • Create a .env file in the root directory.
    • Add your API key as follows: API_KEY=YOUR_API_KEY_HERE.

  4. Run the Application:

    # For Android
npm run android

# For iOS
npm run ios

Contributing

Interested in contributing to the Filmer App? We welcome contributions of all kinds. Please read our Contributing Guidelines for more information.

License

This project is licensed under the GNU GPLv3 - see the file for details.

Acknowledgments