
10/10/2020 Version 0.1

This Media Record format is a series of code/value pairs, 
each pair being two single lines, each terminated with  
a Carriage Return/Line Feed combination (CR/LF).

Comments start with 2 forward slashes. 
Empty lines consisting of a (CR/LF) may be used.
Strings are NOT placed inside quotation marks.
 
The code 0 Media Type Definition and Value pair must be the 
first code/value pair for a Media Record - other code/value 
pairs may follow in any order. 


Media Record format codes:
 ----	-----------		----------	--------	-----------------
 Code	Description		Value Type	Required	Notes - examples:
 ----	-----------		----------	--------	-----------------
 0	Media Type		String		yes		Begins the Media Record
 6	Topic Hierarchy		Strings		no		comma seperated list of Topic Names
 7	Is Favorite		String		no		yes, no. No if not used or empty.
 10	Media Name		String		yes		need something to indentify it
 11	Media URL		String		*yes		*Required for RADU, VIDU


Code 0 Media Type value definitions:
 Must be used.
 -------------------
 Value	Descripion
 -------------------
 AUDU	audio url	- http, https
 VIDU	video url	- http, https
 VIDF	video file	- mp4, etc - folder path set in application
 AUDF	audio file	- mp3, etc - folder path set in application


Code 6 Topic Name Hierarchy:
 Provides a way for an application to construct a contents page (or tree), 
 by using a list of comma seperated topic names.

 For example, a media record with the code 6 value of:
    Radio Streams,USA,Public Radio
 and a code 10 Media Name value of:
    KCNY 105 FM New York 

 would produce a contents page topic hierarchy that looks like:
    Radio Streams
     USA
      Public Radio
       KCNY 105 FM New York

 If no Code 6 is provided, Media Records will be arranged in
 a contents page by their code 0 Media Type. 

 Note a "Favorites" topic should not be used for the Code 6 Topic 
 Hierarchy. An application should create a Favorites Folder at run 
 time, and place in it links to media records marked as a favorite 
 with the code 7 set to "yes". 
 

Predefined Topic Names and Aliases:
 For code 6 Topic Hierarchy - optional.
 For contents page uniformity, smaller file sizes, and better 
 performance, predefined Topic Names and Aliases can be used. 

 Here are some sample definitions. 
 See TopicAlias.txt for the full list.
 ----------------------		-------------------------
 Alias:	Displays:		Alias:		Displays:
 ----------------------		-------------------------
 RS	"Radio Streams"		RSJ		"Jazz Radio"	
 VS	"Video Streams"		RST		"Talk Radio"
 VF	"Video Files"		RSRB		"R & B Radio"
 AF	"Audio Files"		USA		"USA"
 ASP	"Public Radio"		FR		"France"
 ASR	"Rock Radio"		UK		"United Kindom" 



////////////////////////////////////////
Usable example Media Records follow:

0
AUDU
6
RS,USA,RSP
7
yes
10
KCRW 89.9 FM
11
http://kcrw.streamguys1.com/kcrw_192k_mp3_on_air_internet_radio

0
AUDU
6
My Stuff,Radio Stations,Good Ones
7
yes
10
KPCC 89.3 FM
11
https://17793.live.streamtheworld.com:443/KPCC_FM_SC

0
AUDU
6
RS,USA,RSP,RSJ
10
KJAZ 88.1 FM
11
http://1.ice1.firststreaming.com/kkjz_fm.mp3

0
VIDU
6
VS,Khan Academy
10
Oakland Unity High School
11
http://s3.amazonaws.com/KA-youtube-converted/2tYdClfLSCE.mp4/2tYdClfLSCE.mp4








