cornelius-mellino/moviedb-android

Application using the Material design and the TMDb API

What is it?

Movie DB is an Android app with open source code. Movie DB finds information about your favourite movies, TV shows and actors.
Movie DB uses TMDb API which has large collection of information about movies, TV shows and actors. We offer friendly and intuitive user interface. You can view information such as: trailers, images, credits, known for, overview, biography, etc. You can search your favourite actor, movie or TV show. Browse movies by specific genre and more!

### Download from Google Play

Getting started

1. First you need to have installed Android Studio on your computer. You can download it from here.

2. Download the project

git clone https://github.com/sourcestream/moviedb-android.git

3. After you download the project open Android Studio. From there choose Open an existing Android Studio project or File -> New -> Import Project..
4. Open the Movie DB folder that was just cloned from git.
5. Wait until Android Studio finishes building and indexing.
6. Proceed to configuration

Configuration

The configuration file is MovieDB.java, located in the package de.sourcestream.movieDB:

......

public static final String url = "https://api.themoviedb.org/3/"; // main url for the app
public static final String key = "yourTMDBkey"; 
public static final String imageUrl = "https://image.tmdb.org/t/p/"; // used to load movie, TV and actor images
public static final String trailerImageUrl = "http://i1.ytimg.com/vi/"; // used to load trailer images
public static final String youtube = "https://www.youtube.com/watch?v="; // used to load trailer videos
public static final String analyticsKey = "yourGoogleAnalyticsKey";
.....

In order to use MovieDB you need to get your own key from TMDb. You can do that by clicking here.
After you get key replace the string key with your own key.
Now you can run the app by clicking Run -> Run 'app'.

If you plan to use Google Analytics replace the string `analyticsKey` with your own key.

You can find list of the available methods for movies, TV and actors from TMDb API Documentation [here](http://docs.themoviedb.apiary.io/#).

Environment

This project has been build with Android Studio 1.3.2
SDK Build Tools version 23.0.0
Minimum SDK version for the app is 17 (Android 4.2, 4.2.2).
Target SDK version for the app is 23 (Android 6.0).
Movie DB is supported currently for phones only, but you can run it on tablet.
Supported devices: 4709. You can see the full list here.

Libraries

• Universal Image Loader for image loading, displaying and caching.
• Text-Justify
• ObservableScrollView for implementing hiding toolbar feature like in Google Play Store app.
• Parallax Scrolls for making parallaxed views.
• Robolectric for running Android tests directly from inside your IDE.

Contact

This project is developed by sourcestream GmbH.
If you have any questions please do not hesitate to contact us: [email protected] License

Copyright 2015 sourcestream GmbH

Licensed under the Apache License, Version 2.0 (the "License"); 
you may not use this file except in compliance with the License. 
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software 
distributed under the License is distributed on an "AS IS" BASIS, 
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
See the License for the specific language governing permissions and 
limitations under the License.