RNOInfoScreen

WHAT, WHY?
----------

 RNOInfoScreen works as a front-end to various music and media players by
 displaying the "now playing" information with cover art images, and offers
 basic media control options for the user (play, pause, next, etc.).

 Why? Because I listen to music on my MorphOS computers a lot and I wanted
 to have a fullscreen application to display the "now playing" information 
 when I'm not otherwise utilising the computer screen.

 I find myself, quite often, wondering what's currently playing when I listen
 to large random playlists, and my application offers this feature in an easy-
 to-view way, even from some distance away, so I don't have to drag my ass
 back to my computer.

 Why not make it a full-blown player too? Because I'm not trying to re-invent
 the wheel. Everyone has their own favourite music players and characteristics
 for different needs, this program just gives you an alternative way to use
 them.

 Why has it such a generic name? This way I leave my options open, in case I
 expand it to display more than just music related information in the future.


FEATURES
--------

 - Detects the running player and gets the information from it automatically
 - Supported players: Jukebox, SongPlayer, AmiNetRadio, TuneNet 2.4 or later,
   AmigaAMP 2.22 or later, MPlayer (MUI), DAPlayer, RNORadio, RNOTunes
 - Displays information about the previous and currently playing songs
 - Displays album art images, if found, from song's directory, via Internet
   (Cover Art Archive), or as embedded images
 - Configurable cache for downloaded images
 - A clock display
 - Fullscreen and windowed (sizeable) modes
 - Screen blankers can be disabled
 - Last.fm scrobbling support
 - Can be used as a MorphOS blanker with the included binary file
 - Keyboard controls for prev/pause/play/next
 - Hidden volume control/display by using the up/down cursor keys, or the
   middle mouse wheel
 - Hidden quit (top left if in fullscreen mode) and screen swap (top right of
   screen if in fullscreen mode) by single left mouse-click on corner pixels.
 - ARexx support


REQUIREMENTS
------------

 - A working ARexx environment with RexxMast running (rexxsyslib.library
   installed on MorphOS)
 - On a classic Amiga: high or true color RTG, KS3.0+ and plenty of RAM, but
   no guarantee it will perform OK on a real machine, probably not so well.
 - codesets.library and reqtools.library on AmigaOS 3 and 4, WarpOS, and AROS


INSTALLATION
------------

 - Copy an executable or the whole directory anywhere you want, no further
   installation required
 - To use as a blanker in MorphOS, copy the RNOInfoScreen.btd file to the
   SYS:Classes/Blankers directory or use the provided install script.


USAGE
-----

 - Start the music playback on any of the supported players and then just
   launch this program
 - Double-click or rcommand-f switches between fullscreen and windowed modes
 - Displayed elements can be enabled and disabled from the pull-down menu
 - Move the mouse around to activate the display of the player control buttons
 - Volume can be controlled with the mouse wheel or from the keyboard, by
   pressing the up/down cursor keys to increase/lower the system volume,
   visual representation of the volume control level is shown as a range of
   vertical bars in the upper left corner of the window/fullscreen. The volume
   controls can be lowered/raised in greater increments, in MorphOS, by
   holding down the shift key and using the volume control key/mouse options,
   already explained

 - Keyboard controls:
     Right - Next
     Left  - Previous
     Up    - Volume up
     Down  - Volume down
     Space - Pause
     Enter - Play
     Esc   - Quit
     Tab   - Launch an external script


SETTINGS
--------

 The following settings can be altered from the pull-down menu of the program.


 Generic settings:

 "Double-click for fullscreen?"
 - Fullscreen/windowed modes can be switched with a double-click anywhere.

 "Borderless window?"
 - Opens on a borderless window in a windowed mode. 

 "Disable blanker?"
 - No system blanker will activate, and the monitor won't get turned off when
   the program is running.
 - Requires a restart of the program for this to take effect.

 "Scrobble to Last.fm?"
 - Previously played song will be sent to Last.fm if you have the UniScrobbler
   script installed (http://aminet.net/package/mus/play/UniScrobbler) and the
   song was played longer than 30 seconds.
 - Works only on MorphOS.
 - Remember to avoid double scrobbles if you are already using the script with
   the music player!


 Album art settings:

 "Search album art from -> File (embedded)"
 - MP3 files are searched for embedded images (ID3v2.3.0 standard)

 "Search album art from -> Local directory"
 - Album art images are searched from the directory the song was loaded.
 - Search order is a PNG or JPEG image with a word "front", "cover", or
   "album*art" in its name and if the directory contains less than 40 files.
   If this image isn't found, filename containing album name is searched next,
   then any image file if the directory contains less than 20 files, and
   finally if nothing else if found, image with a word "folder" is loaded.

 "Search album art from -> Internet"
 - If the local search is disabled or doesn't supply any results, the album
   art is searched from the Cover Art Archive site and saved to a cache
   directory.

 "Select album art cache directory..."
 - The cache directory is in T: by default and so will be lost upon any reboot.
 - Change the directory location to HD to keep any downloaded album art images
   permanently, so you no longer need to re-download them.

 "Show default image if album art is not found?"
 - A default image is shown (instead of a blank view) if album art isn't found

 "Select the default image..."
 - The built-in default image can be changed to any other image.
 - Alpha transparency is supported with PNG images.
 - The program archive includes two example images.


 Background image settings:

 "Select the default background image..."
 - If you want to view background images, you can select a default image here.

 "Search background images from -> Default directory by artist names?"
 - A custom background image is searched from the default background image's
   location (it needs to be selected).
 - A file containing an artist name (from ID3 tags) is searched. If an artist's
   name contains spaces, the file must contain spaces too. For example,
   "Madonna.jpg", "Michael Jackson.png", etc..

 "Search background images from -> Default directory randomly?"
 - A random background image is selected from the default background image's
   location (which initially needs to be chosen).

 "Search background images from -> Song's directory?"
 - If the song was loaded from a directory containing a file named
  "background.jpg", it will be loaded as the background image.

 "Use album art as a background image?"
 - The album art image will be scaled to fit as the background image.
 - Overrides any other background image settings.

 "Preserve the aspect ratio?"
 - If selected, background images will be scaled and cropped preserving their
   original aspect ratio, otherwise images are stretched to fill the display.

 "Shadows when using a background image?"
 - Texts and control buttons acquire/take-on drop shadows to improve their
   visibility.


 Color settings:

 "Colors -> Default text..."
 - Opens a color requester for the color of all text, other than song names.

 "Colors -> Song name..."
 - Color for the song names.

 "Colors -> Buttons..."
 - Color for the track control buttons.


 Saving the settings:

 "Snapshot window"
 - Saves the size and position of a windowed mode window.

 "Save settings"
 - Saves all other settings and view selections to ENVARC:RNOInfoScreen/.


MORPHOS BLANKER SETTINGS
------------------------

 There are three options in the blanker settings in the MorphOS preferences:

 "Exit on user input"
 - The blanker quits if you move the mouse or press any key if there isn't any
   playback. If there is playback, the previously mentioned controlling keys
   can be used without quitting the blanker. If the option isn't enabled, you
   can use menus and mouse controls, but you have to quit manually.

 "Turn off the monitor if no player found"
 - The blanker turns the monitor off immediately instead of showing the clock
   display if no supported player is running.

 "Don't let the system turn off the monitor"
 - The blanker screen stays visible and the monitor isn't turned off even if
   the timeout is set in the MorphOS preferences for turning off the monitor.


AREXX
-----

 Program's ARexx port is RNOINFOSCREEN and supported commands are:

 FULLSCREEN  . . - Toggles fullscreen mode
 VOLUMEINC . . . - Increases volume
 VOLUMEDEC . . . - Decreases volume
 NEXT  . . . . . - Loads the next song
 PREV  . . . . . - Loads the previous song
 PAUSEON . . . . - Pauses playback
 PAUSEOFF  . . . - Resumes playback
 EXTSCRIPT . . . - Executes the external script
 QUIT  . . . . . - Quits the program
 GETVERSION  . . - Returns the program version
 GETFULLSCREEN . - Returns the fullscreen state
 GETARTIST . . . - Returns the artist name
 GETSONG . . . . - Returns the song name
 GETALBUM  . . . - Returns the album name
 GETFILE . . . . - Returns the filename
 GETPLAYER . . . - Returns the player name


HISTORY
-------

 Version 1.1:
 - Added stream handling (a URL with MPlayer, but stream titles with others)
 - Better parsing with MPlayer

 Version 1.2:
 - Fixed TuneNet support
 - Fixed paths with square brackets
 - Small changes to the blanker execution

 Version 1.3:
 - Added background image and shadowing options
 - Added configurable colours
 - Added alpha transparency support for default images

 Version 1.4:
 - More options for background images
 - Volume increases faster up and down on MorphOS with the shift key pressed
 - Repeating keyboard commands
 - Uses own AppIcon
 - Added invisible close and depth gadgets on the fullscreen mode
 - More system friendly menus
 - Improved the local search option

 Version 1.5:
 - Added support for embedded images in MP3 files (ID3v2.3.0)
 - Fixed a crash when the program is iconified
 - Added an on-screen volume level indicator
 - Improved the invisible depth gadget functionality
 - Added UTF-8 support
 - Added an option to launch an external script with the tab key
 - Added the ARexx support

 Version 1.6:
 - Added support for Digital Audio Player
 - Added the borderless window option
 - Settings weren't saved on certain OS3 versions

 Version 1.7:
 - Embedded images in MP3 files are supported with all ID3v2 versions now
 - Added support for RNORadio

 Version 1.8:
 - Added the embedded image support for FLAC files
 - Added support for RNOTunes
 - FLAC metadata is read from a file if a player doesn't support it
 - Fixed the album art downloading (requires AmiSSL now)
 - External Last.fm support is replaced by a built-in solution
 - Added work-arounds to get the program to work on AROS too


WEB
---

 - Please visit https://jpv.amigaaa.com/ for screenshots, support, donations,
   and other software.
 - This program is made with Hollywood: https://www.hollywood-mal.com/
 - A short video clip: https://m.youtube.com/watch?v=YNx7Axwhx1E&t=11m17s


THANKS TO
---------

 - Densho/RNO for the logo
 - Neil Pearson for proof-reading and testing


DISCLAIMER
----------

 This software is made available to you as Freeware and you may use this
 software in whatever way you wish, but the author accepts no liability for
 any damage caused to your system, other connected peripherals, or data files
 in any way by using this software.

 Please consider the time and effort I put in to create this utility for your
 use and enjoyment. If you feel it is useful to you, please consider sending me
 a PayPal donation that represents the benefit you gain from using it. The
 donation can be sent to the email address quoted in this ReadMe.txt file
 (Uploader) or click the Donate button shown on https://jpv.amigaaa.com