﻿
MoviePoster Release 2.3.0.1 Final (1-7-2018)


--------------------------------------------------------------------------------------------------------------------
INTALLATION NOTES
--------------------------------------------------------------------------------------------------------------------
 - Requires the .Net framework version 4.5 (supported on Microsoft Windows Vista and above)
 - There is currently no installer for the application. Just copy the application directory to your desired 
	location and run MoviePoster.exe 
 - If using XBMC integration, make sure that your XBMC box is pingable from the pc running MoviePoster. 
	If ping times out, MoviePoster will not attempt a connection to that host.  In some cases Windows 7 
	will not reply to ping requests and needs a firewall rule added. See this article for details: 
	http://www.sysprobs.com/enable-ping-reply-windows-7
 - Be sure to take a look at the settings and make any desired changes.
 - This software comes with no warranty or guarantee and may contain bugs, crash or cause data corruption. 
	(Although I've done my best to make sure that doesn't happen.) 
 - See changeLog.txt for new features, behind the scenes changes, and possible future enhancements. 

--------------------------------------------------------------------------------------------------------------------
GENERAL USAGE NOTES
--------------------------------------------------------------------------------------------------------------------
 - MoviePoster will start to download posters from themoviedb.org the first time its run. This process can take 
	a while, please be patient. 
 - Web browser based control is avalable and is the recomended primary control method, however it is still 
	somewhat experimetal. The 'Webremote' is optimized for mobile devices such the iPad and has also been 
	tested in the Google Chrome browser.
 - Depending on your browser and settings, you may need to manually refresh pages to see the most recent data.
 - If you have a lot of posters, the cache, and list views can take a while to load, just be patient.  
 - Some tasks, such as adding a new movie to the cache, or downloading a new list from themoviedb.org can take a 
 	while to complete. You'll need to wait for the task to complete, then refresh the page to see new data. 
 - When changing any settings in the application menu its best to restart the application as a few things are only 
	applied on startup. 
 - MoviePoster retrieves posters and movie data from themoviedb.org. You can set the categories and number of pages 
	to retrieve in the application settings. The default setting is to retrieve one page for each category, but you 
	can increase the max pages to get a lot more posters in the mix. Each page seems to return a maximum of 20 posters. 
	So if you set it to 10 pages, it will retrieve data for up to 200 movies in that category. However, the queries 
	will only return the max pages provided by themoviedb.org. for 'Now Playing' and 'Upcoming' its usually between 
	1 and 3 pages, so don't expect to get a ton of results if those are the only queries you have selected. If you 
	want to get a better idea of which movies are in each category, go check out http://www.themoviedb.org/movie and 
	select the different tabs for the categories.
 - Trailer support makes use of mPlayer and youtube-dl. It does take a little while for mplayer to initialize the first
	time, so you might see a black rectangle for a few seconds while it loads. 
 - Webview (HTML5) displays can be presented on any device with a compatible web browser. You can find the URL for each 
	WebView display in the displays tab in the settings menu. 
	for example:  http://thinkpad:8082/webview.html?displayid(1)  is the WebView address for displayid 1 
	hosted on a PC with the hostname 'thinkpad' . an optional second parameter is used to specify the 	
	width of the poster area, for example: http://thinkpad:8082/webview.html?displayid(1,480) scales the 
	display to 480 pixel width. 720 pixles is used if there is no value specified.

--------------------------------------------------------------------------------------------------------------------
 CONTROL
--------------------------------------------------------------------------------------------------------------------
 - The web interface is the recomended method of control. The web interface is available using a web browser and 
	navigating to one of the control addresses at the IP of the machine running MoviePoster on the specified port. 
	for example: http://127.0.0.1:8082/remote.html will load the remote in a local web browser on the default port.
	MoviePoster uses an internal webserver and must be running for the web interface to be available. 
	other pages include: 
	http://127.0.0.1:8082/blacklist.html 
	http://127.0.0.1:8082/customlists.html 
	http://127.0.0.1:8082/movielist.html 
	
	- List pages have a + icon in the upper right for adding items to a list.
	- The x icon on a list item allows you to remove items from the list or cache.
	- changes to custom lists are submitted immediately when checking or unchecking an item. 
 
 - Keyboard/mouse control is supported for basic operation and application settings.
	- right click  or double click on the poster image will bring up the Options Menu.
	- the left/right arrow keys will change the poster currently displayed.
	- space bar will pause on the currently displayed poster. 
	- the T key toggles the trailer view.     

 - EventGhost
	- See http://www.movieposterapp.com/downloads.html for an EventGhost plugin allowing control of many functions using 
		http commands. 
	 

--------------------------------------------------------------------------------------------------------------------
 REGISTRATION
--------------------------------------------------------------------------------------------------------------------
 - Registration is not required, but is appreciated and helps to support continued development and support of the 
 	application. To obtain a registration code simply make a donation towards MoviePoster development. All donators 
	will be issued a registration code. If you do not receive your registration code within 24 hours, please send 
	me an email at movieposterapp@gmail.com.  Registration requires an internet connection to complete. A registered 
	installation is  locked to the PC it was registered on. Once the registration process is complete a 'MoviePoster.lic' 
	file will be generated in the same directory as the MoviePoster executable. This file can be backed up/restored and 
	used to avoid re-registering a new installation on the same PC. 
 

--------------------------------------------------------------------------------------------------------------------
 DONATIONS
--------------------------------------------------------------------------------------------------------------------
 If you find this software useful, please consider making a donation to support continued development. 
 I greatly appreciate it. There is a donation link available in the web remote interface, settings window and on the 
 MoviePoster website at www.movieposterapp.com. A registration code will be issued to all donators. If you wish to 
 support MoviePoster by donating develpment harware or in any other way, please send an email to movieposterapp@gmail.com  

--------------------------------------------------------------------------------------------------------------------
 CONTACT
--------------------------------------------------------------------------------------------------------------------
 For support, questions, bug reports and feature requests please send an email to: 
 movieposterapp@gmail.com 
 
 Include 'MoviePoster Support' in the subjectline along with the version number.
 I make no guarantee that I can solve your problem, but I'll try.  

--------------------------------------------------------------------------------------------------------------------
 LICENSE
--------------------------------------------------------------------------------------------------------------------
 This software makes use of GPL licensed libraries and code and as such is released under the GNU GENERAL PUBLIC LICENSE, 
 Version 3.

 Source code is available by written request only. Distribution fees may apply.

     Copyright (C) 2018  Brent Meyer

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.