Official Kodi Wiki - User contributions [en]

Samples

2022-09-30T09:43:03Z

Zag: /* Library samples */

{{mininav| [[Troubleshooting]] {{l2|[[Development builds]] }} }}

{{forum link2|1=Questions? Comments? See the ''[http://forum.kodi.tv/showthread.php?tid=248794 discussion thread]''}}

''(List and links compiled and maintained by @hdmkv)''

Kodi users are a demanding bunch when it comes to media players with Kodi & having as-close-to-perfect video playback capabilities as possible. All videos should play smoothly and w/o distracting artifacts such as stutters, frame skips, improper framerates, macroblocking, and audio drop-outs.

Below is a collection of a/v clips for testing, pushing media player capabilities. Not all types, but the most widely used or critical types for home theater enthusiasts. [[w:Fair use|Fair use]] is claimed on all non-[[w:copyleft|copyleft]] clips, as their the purpose is only for testing, technical evaluation, and documentation.

For any YouTube video, [https://www.4kdownload.com/products/product-videodownloader use this free tool] to download.

==4K (UltraHD) Formats==
#[https://drive.google.com/file/d/0BwxFVkl63-lEY3l3ODJReDg3RzQ/view?usp=sharing&resourcekey=0-5kDw2QbFk9eLrWE1N9M1rQ H.264 29.97fps, 51Mbps] (in mov, ''@hdmkv's'' iPhone 6S raw 4K footage)
#[https://www.youtube.com/watch?v=Ppz41EmaJyU H.264 30fps] (in MP4, 4K Test Patterns) (YouTube) ''(thanks @hansolo)''
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=111 H.264 50fps] (in MP4, Astra DVB satellite capture sample)
#[http://www.demo-world.eu/download-2d-trailers-uhd/?file=samsung_seven_wonders_of_the_world_china_uhd-DWEU.mkv&pic=samsung_seven_wonders_of_the_world_china.jpg H.264 59.94fps] (in MKV)
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=101 HEVC 8-bit 29.97fps] (in MP4)
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=45 HEVC 10-bit 23.976fps] (in TS)
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=96 HEVC 10-bit 59.94fps] (in TS)
#[https://drive.google.com/file/d/0BwxFVkl63-lEdVBuZkltckdZZ0k/view?usp=sharing&resourcekey=0-k91iv2m3Plumc5jdKCbxdQ HEVC 10-bit 59.94fps] (Korean ATSC 3.0 satellite TV capture sample)
#[http://hdrsamples.com/ HDR 10-bit HEVC 24fps] (in MP4, 'Exodus' and 'Life of Pi' samples)
#[https://drive.google.com/file/d/0BwxFVkl63-lEdU9Ma0VYc3YxSVE/view?usp=sharing&resourcekey=0-FJsSx7fEhiVEtQMRwo_ePQ HDR 10-bit HEVC 25fps] (in TS, Astra DVB satellite capture sample; no audio) ''(courtesy WeTek)''
#[https://www.projectorcentral.com/images/articles/10bit_HDR_Grayscale_ProjectorCentral_4K_(HEVC_10-bit).mp4 HDR 10-bit Grayscale Rotating Gradients] (hosted by Projector Central)
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=144 HDR 10-bit HEVC 59.94fps] (in MP4, Camp by Sony)
#[https://drive.google.com/file/d/1Ic9DZXMSo07EJMqCFaQRKSSrSw6y1mYv/view?usp=sharing HDR10 HEVC 59.94] (in mov, ''@hdmkv's'' iPhone 11 Pro Max raw 4K footage using [https://apps.apple.com/us/app/4k-hdr-video-recorder/id1203170948 4K HDR Video Recorder app])
#[https://drive.google.com/u/0/uc?id=1Nz2MPf2FPz3A99ciBSAl3m0U0XBbV1bv&export=download HDR10+ Int'l Space Station Sample] (in 24fps TS)
#[https://mega.nz/file/af4zSAbQ#gBiHRiX3oLnBvxMNnytC08v8DRkKzQIkhGpg96nAWXE HDR10+ Profile A HEVC 10-bit 23.976 Sample] (in MKV with DTS:X audio)
#[https://mega.nz/file/nehDka6Z#C5_OPbSZkONdOp1jRmc09C9-viDc3zMj8ZHruHcWKyA HDR10+ Profile B HEVC 10-bit 23.976 Sample] (in MKV with EAC-3 JOC ATMOS audio)
#[https://ff.de/hdr10plus-metadata-test/ HDR10+ Dynamic Metadata Test 60fps] (in MP4)
#[https://drive.google.com/file/d/1cTRNwacsV-8J8PtcYNVDXBmGZF1SOynj/view?usp=sharing Dolby Vision w/embedded HLG HEVC 59.94] (in mov, ''@hdmkv's'' iPhone 11 Pro Max raw 4K footage using [https://apps.apple.com/us/app/4k-hdr-video-recorder/id1203170948 4K HDR Video Recorder app])
#[https://img.photographyblog.com/reviews/apple_iphone_13_pro/sample_images/4K60p.mov Dolby Vision w/embedded HLG HEVC 60fps] (in mov, Photography Blog's iPhone 13 Pro raw 4K footage)
#[https://drive.google.com/file/d/0BwxFVkl63-lEc3k0aldZaGtaVm8/view?usp=sharing&resourcekey=0-ECypkFcgdKx1YiojpUCWBA Dolby Vision 10-bit HEVC 23.976fps] (in TS, LG Comparison Demo) ''(thanks @soyhakan)''
#[https://drive.google.com/file/d/0BwxFVkl63-lEWmNWcGl4eVRWS2M/view?usp=sharing&resourcekey=0-WkmICjhK5yus4EAaPuSuSw Dolby Vision 10-bit HEVC 23.976fps] (in TS, LG Trailer) ''(thanks @soyhakan)''
#[https://www.makemkv.com/download/dvtest/ Dolby Vision MKV Test Samples] (hosted by MakeMKV, these are great for evaluating the full DV range)
#[https://mega.nz/folder/FSog3BhS#UzG3Mrrs_vuT1Qy-lZIhhg Dolby Vision FEL Test Samples] (shared by ''@markswift2003''; see [https://www.avsforum.com/threads/dune-pro-vision-4k-dolby-vision-fel-and-rpu-response-other-random-stuff.3188469/post-60582530 instructions on how to assess])
#[https://developer.dolby.com/tools-media/sample-media/video-streams/dolby-vision-streams/ Dolby Vision 'Glass Blowing' Test Samples (Profiles 5 & 8.1)] (hosted officially by Dolby Developer)
#[https://mega.nz/file/DGJU1BzL#4jtSK9Kvx2N6WuNdnQXyOi4NFEqLIymLrmSK5R8WilY Dolby Vision Color Accuracy Sample (Profile 7)] (assess proper color rendering, flesh tones)
#[https://www.demolandia.net/4k-video-test/dolby-vision/page-1.html Dolby Vision MP4 Test Samples] (hosted by Demolandia)
#[https://www.youtube.com/watch?v=s6zR2T9vn2c VP9] (open-source alternative to HEVC) (YouTube)
#[https://mega.nz/#!pQEGgRwY!pD9whIlM-U9tJIA-LojxSt582BAZGfdSA5wAQLT06I4 VP9 Profile 2 HDR 24fps] The Redwoods (in MKV) ''(thanks @wesk05)''
#[https://mega.nz/#!hJdFEIBI!uSOjZtkkjIVYSfqD9aSfONf1yq__uQvlsf47pCtFvdQ VP9 Profile 2 HDR 59.94fps] The World in HDR (in MKV) ''(thanks @wesk05)''
#[https://storage.googleapis.com/media.webmproject.org/devsite/vp9/hdr-encoding/strobe_scientist.mkv ProRes HDR DCI-P3] Strobe Scientist
#[https://www.youtube.com/watch?v=nRt4Duf7GoI 5K (5120x2700) 60fps] (in MP4) (YouTube)
#[https://www.demolandia.net/downloads.php?id=60876578 HEVC 10-bit 23.976fps] (in MKV)
#[https://www.youtube.com/watch?v=ChOhcHD8fBA 8K (7680x4320) 29.97fps] (in MP4) (YouTube)
#[https://youtu.be/3SjX_X0oGxo 8K Dolby Vision 60fps] (in MP4) (YouTube)

==HD/object-based Audio Test Clips==
#[https://mega.nz/#!cM9VmBSL!mME5qULH2H5M24vLmjqfZZkaoUjY6RsrGPiw3ultMW0 Dolby Digital Plus (E-AC3) 7.1] (M2TS @ 1080p/29.97) ''(thanks @wesk05)''
#[http://www.demo-world.eu/download-2d-trailers/?file=dolby_digital_plus_channel_check_lossless-DWEU.mkv&pic=dolby_digital_plus_channel_check_lossless.jpg Dolby Digital Plus (E-AC3) 7.1 Channel Check] (MKV @ 1080p/29.97)
#[https://drive.google.com/file/d/1_Gc0v7glw5hGJ6l37En5YKDPnPSLR6HM/view?usp=sharing Enhanced AC3 with Joint Object Coding (EAC-3 JOC) ATMOS Sample] (MKV @ 4K/23.976 HDR10)
#Dolby TrueHD 5.1 (use clip #9 in 'Codecs' section below)
#[http://www.demo-world.eu/download-2d-trailers/?file=dolby_truehd_channel_check_lossless-DWEU.mkv&pic=dolby_truehd_channel_check_lossless.jpg Dolby TrueHD 7.1 Channel Check] (MKV @ 1080p/29.97)
#[http://www.demo-world.eu/download-2d-trailers/?file=dolby_amaze_lossless-DWEU.m2ts&pic=dolby_amaze.jpg Dolby ATMOS 'Amaze' Demo] (M2TS @ 1080p/24)
#[https://drive.google.com/file/d/0BwxFVkl63-lENElIcC1xTnF2Yk0/view?usp=sharing&resourcekey=0-1_ByUhiruAwxfSNqW4ryAQ Dolby ATMOS 'Helicopter' Demo] (M2TS @ 1080p/29.97 with DD+ 7.1 secondary track)
#[https://www.demolandia.net/downloads.php?id=236762 Dolby ATMOS 'Audiosphere' Demo] (M2TS @ 1080p/24)
#[https://www.demolandia.net/downloads.php?id=52783232 Dolby ATMOS 'Silent' Demo] (M2TS @ 1080p/24)
#[https://drive.google.com/file/d/0BwxFVkl63-lEcU1ScWZuMjhpOXM/view?usp=sharing&resourcekey=0-Kw7GSvWtpTG5WNFXvJXxNw DTS-HD HRA 5.1] (MKV @ 1080p/23.976 VC-1)
#[http://www.demo-world.eu/download-2d-trailers/?file=dts_orchestra_short_lossless-DWEU.mkv&pic=dts_orchestra.jpg DTS-HD HRA 7.1] (MKV @ 1080p/29.97)
#[https://www.demolandia.net/downloads.html?id=30191483 DTS-HD MA 5.1 Channel Check] (MKV @ 1080p/23.976)
#[https://drive.google.com/file/d/1HyQE5eqvV8BewCdbR9Xq3jbh1eUX0zXN/view?usp=sharing DTS-HD MA 5.1 THX Deep Note Genesis] (MKV @ 2160p/24)
#[https://drive.google.com/open?id=0Bx63o79bMC7lMEMxUmxzV2NtYTA DTS-HD MA 7.1 'Dredd' Audio Channel Check] (M2TS @ 1080p/23.976) ''(thanks @looun)''
#[http://www.demo-world.eu/download-2d-trailers/?file=dts_x_all_around_us_lossless-DWEU.mkv&pic=dts_x_all_around_us.jpg DTS:X 'All Around Us' Demo] (MKV @ 1080p/23.976) ''(thanks @wesk05)''
#[https://drive.google.com/file/d/0BwxFVkl63-lEQWNKRnBPUlB3QXc/view?usp=sharing&resourcekey=0-m0bCKOSBLih3jvvfMwLSxA DTS:X 'Gravity' Demo] (MKV @ 1080p/23.976) ''(thanks @wesk05; modified to only retain the X track)''
#[https://www.demolandia.net/downloads.php?id=87980801 DTS:X 'Sound Unbound Callout 11.1' Demo] (M2TS @ 1080p/24)
#[https://www.demolandia.net/downloads.php?id=69530805 DTS:X 'Listen X Long' Demo] (M2TS @ 1080p/24)
#[https://mega.nz/#!0NVhDIbY!D4Fte7Kb7728H9CRY3IVTHJ45ZwkCQiugdFS7pZCN_s DTS:X 'Movement' Demo] (M2TS @ 1080p/23.976) ''(thanks @wesk05)''
#[https://mega.nz/#!Rcl1ECiL!pzPT5LvMyYIoKbsm3HdMDi2vO6aPpE8gAjLsSTH1DZg LPCM 5.1] (MKV @ 1080p/23.976) ''(thanks @wesk05)''
#[https://drive.google.com/file/d/0BwxFVkl63-lEV2JjazFWQ05OSG8/view?usp=sharing&resourcekey=0-gZ3u3gtnO6cC4qw6dgg1nw LPCM 7.1] (MKV @ 1080p/23.976)
#[https://www2.iis.fraunhofer.de/AAC/multichannel.html AAC 5.1]
#[https://drive.google.com/file/d/1dWB93rzbd3tuHckQH8ZisnJd7NDgApoe/view?usp=sharing FLAC 5.1 and 7.1 audio-only samples]

==3D Test Clips==
#[https://drive.google.com/file/d/0BwxFVkl63-lEd2c0ekxfbFd3Tmc/view?usp=sharing&resourcekey=0-xPh7W5aHnTo4SNN790Lscg 3D MVC ISO Sample #1] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lEM2xjQndxV3ZzaVE/view?usp=sharing&resourcekey=0-ugbr-4FiuVyADmYOK_oXoQ 3D MVC ISO Sample #2 with 3D Subtitles] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lEMkJTV21JNnhfNlE/view?usp=sharing&resourcekey=0--B5KIzJq8TkuruFtWZy0Ig 3D MVC ISO Sample #3 for Pop-out & Depth Evaluation] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lEWmRyc0YwUExxX0U/view?usp=sharing&resourcekey=0-JS17Gxnro9jCG_3sY_kXcg 3D MVC ISO Sample #4 for Proper Lip-synch & Clean Render Check] (1080p/23.976)
#[https://mega.nz/#!8BcClSRb!Jd48Bfc-8DjGvr7upqDVaDz5RdRI1xdR0PQ1-kZIAsI 3D MVC Resolution Pattern] (1080p/23.976) ''(Per @wesk05 (thanks), pay attention to the alphabets and the vertical & horizontal bars. If you see gray lines in the vertical resolution boxes, it's an indication that either the playing device or the display is not showing full 1080p resolution in 3D mode)''
#[https://thedigitaltheater.com/avatar-the-way-of-water-2022/ 'Avatar: The Way of the Water' 3D ISO & SBS Trailers]
#[https://we.tl/GVI7OpbcYU 3D MVC ISO Barco Stinger Trailer] (1080p/24)
#[https://we.tl/LirYPMi3Y7 3D MVC ISO Dolby 3D Glasses Return Clip] (1080p/24)
#[https://drive.google.com/file/d/0BwxFVkl63-lETWMzM1dRZF9XMDA/view?usp=sharing&resourcekey=0-RgKV_-y3FZVwsvrsukuvfw 3D Immersive MVC Sample] (MKV @ 1080p/23.976)
#[https://drive.google.com/file/d/1hGOmRT8tDXaM9-KdAmD-f0IUP1OZBgZe/view?usp=sharing 3D MVC IMAX Countdown] (MKV @ 1080p/23.976 with DTS-HD MA 5.1)
#[https://mega.nz/file/eO5QmTxa#WgYpyzYqSkscLTLI3BztXCLbCo3h6ZAUyAgesNCMNLw 3D MVC DTS Paint Symphony] (MKV @ 1080p/23.976 with DTS-HD MA 7.1)
#[https://we.tl/t-SBSah1jIKx H(SBS) Alita Battle Angel Trailer (side-by-side)] (MKV @ 1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lET0czejJBVXJLSkE/view?usp=sharing&resourcekey=0-nN7dFCvZTmALjj3H_4G1uw H(TAB)/HOU (top-and-bottom/half-over-under)] (MKV @ 1080p/23.976)

==Codecs, Framerates, Black-levels and Subtitles==
#[https://drive.google.com/file/d/0BwxFVkl63-lERkJRU003ZTd2VEk/view?usp=sharing&resourcekey=0-swC_jMVMd_EXmweT0tGKSg H.264 1080p/23.976] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lEdzlZZ2lCLTVLa2c/view?usp=sharing&resourcekey=0-iCq6zrc9whsrif4-Zvu0DQ H.264 1080p/24] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lEbFBzak1sbmU1N0E/view?usp=sharing&resourcekey=0-GOK3gZYAmP-ywn6T9zCDoQ H.264 1080i/25] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lEWDUzUVUtZEw4cDA/view?usp=sharing&resourcekey=0-xLf9zGIdfdibsOe8L5JWDg H.264 1080p/25] (MKV)
#[https://mega.nz/#!XI1yiKLA!rF4vweNo_xA7vpSzpLU-JctqfUGZN4vVU1m6WIJ5lT4 H.264 1080i/29.97 4:2:0@High 26Mbps] (C-Band satellite capture in MKV w/DTS-HD MA 2.0 audio, converted from E-AC3) ''(thanks @alanisrox69)''
#[https://drive.google.com/file/d/0BwxFVkl63-lEbVptTVZ2NENURHM/view?usp=sharing&resourcekey=0-ZkTnO85pBHyp7fYNMHGyjQ H.264 1080p/50] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lEUGZnR1JHUUU0WEk/view?usp=sharing&resourcekey=0-YrNv_pEiY4Ukaw_X5rckRw H.264 1080p/59.94] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lETTVtaVV0LUVRZ1k/view?usp=sharing&resourcekey=0-rQVL39j5O_oysqA4xOSefQ H.264 1080p/60] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lETFVpOWRVVGNfeEU/view?usp=sharing&resourcekey=0-e9HrVO61IGkoTc_GBMNbww VC-1 1080p/23.976] (MKV w/TrueHD 5.1 audio)
#[https://drive.google.com/file/d/0BwxFVkl63-lERnhlY1pHeW5wbjQ/view?usp=sharing&resourcekey=0-EZX7FzpNtVgz7U0lUDejfg VC-1 1080i/29.97] (MKV w/DTS-HD MA 5.1 audio)
#[https://drive.google.com/file/d/0BwxFVkl63-lETXlOa3hEMmVyZGM/view?usp=sharing&resourcekey=0-FG5JbjCsd8QduRhkZ2aT8A MPEG2 1080i/29.97] (U.S. ATSC OTA capture, muxed into MKV w/DD5.1 audio)
#[https://mega.nz/#!GJMAADTK!deabwHlqtw2I_ihoY6_0xnxT_1W_d3jpAjnANKRBAzE MPEG2 4:2:0@High 1080i/29.970 36Mbps] (C-Band satellite capture in TS w/DTS-HD MA 5.1 audio, converted from E-AC3) ''(thanks @alanisrox69 for #12-14)''
#[https://mega.nz/#!jREAxYgb!MtjBIh1oSJJBZgLT7AcdG88hGCFG-ak7pC2AyjrsaIQ MPEG2 4:2:0@High 720p/59.94 20Mbps] (C-Band satellite capture in TS)
#[https://mega.nz/#!c9dhAaKA!MG5Yi-MJNATE2_KqcnNJZCRKtTWvdjJP1NwG8Ggdw3E MPEG2 4:2:2@High 1080i/29.97 35Mbps] (C-Band satellite capture in TS w/DTS-HD MA 5.1 audio, converted from E-AC3) (many media players can't play this)
#[https://www.dropbox.com/sh/6iy4gxgsfn14opq/AAAK_L1M_NwZwBPb5IkEPh7Ga?dl=0 Hi10 Anime Samples] ''(thanks @Morien)''
#H.265 1080p (medium bitrate) Test #1 [https://drive.google.com/file/d/0B3-obtCH8dE8d04yQnY5ZkFJdVE/view?usp=sharing in ISO], and [https://drive.google.com/file/d/0B3-obtCH8dE8V0NXdi1Jd3NrNkk/view?usp=sharing in MKV] ''(thanks @Mike)''
#[https://drive.google.com/file/d/0BwxFVkl63-lEbWhqS284RkpNMXc/view?usp=sharing&resourcekey=0-QvcZotOvzcEttZqO0k-xCg 2D Forced Subtitles Sample #1 (SRT)]
#[https://drive.google.com/file/d/0BwxFVkl63-lEVEluSFZ4NlhpLUk/view?usp=sharing&resourcekey=0-jrRNAhII3KVOq5Qid60tCw 2D Forced Subtitles Sample #2 (PGS)]
#3D Subtitles (use clip #2 in '3D Test Clips' section above)
#[http://www.hifiandtheater.com/files/intimax-test.mkv Black Level Test #1 Sample] (evaluate quality of your display's blacks in SDR) (1080p MKV) ''(thanks @hifiandtheater.com)''
#[https://mega.nz/file/OaJnkSzb#sqR1bLb5IT7AXJS_o2SJQwXuNv4oRYsIDwMN6Ov1Hrs Black Level Test #2 Sample] (evaluate quality of your display's blacks in HDR) (4K MKV)

==Bitrate Test Clips==
Media players should be able play 70Mbps or better smoothly, w/o stutters for full 1080p, and 108-128Mbps for full 4K

*[http://jell.yfish.us/ Jellyfish, up to 400Mbps] (in H.264 and H.265 HEVC MKV) ''(thanks @ScottAllyn01 for your invaluable site)''
*[http://dl.ganjanetwork.ru/Files/Video%20Test%20Files/Bitrate/Birds/ Birds, up to 90Mbps] (in H.264 MKV or M2TS)

==Resources for Additional Test Clips or Samples==
*[https://www.demolandia.net Demolandia] (4K and 3D trailers trailers)
*[https://thedigitaltheater.com/ The Digital Theater] (several excellent ATMOS, 3D, IMAX, etc. trailers)
*[http://www.demo-world.eu/2d-demo-trailers-hd/ Demo World trailers] (several directly linked to above)
*[http://bbb3d.renderfarming.net/download.html Big Buck Bunny] (test suite with 2D, 3D and 4K clips)
*[http://www.cnx-software.com/2010/03/17/where-to-get-video-audio-and-image-samples/ CNXSoft's samples/links]
*[http://www.w6rz.net/ W6RZ MPEG2 clips]
*[https://www.koi-sama.net/files/hi10/ AVC High 10 Profile Anime Samples] ''(thanks @Morien)''
*[http://4ksamples.com/ 4Ksamples.com] (movie, sport, nature clips in 4K)
*[https://www.youtube.com/user/jacobschwarz/videos Jacob + Katie Schwarz: We See the World in 4K] (beautiful 4K nature videos) (YouTube)
*[https://www.youtube.com/user/aroundtheworld4k/videos Around the World 4K] (Cities worldwide in striking 4K) (YouTube)
*[https://www.youtube.com/channel/UCW35MLO96M_UVG7YzMt1I2A/videos Cities in 4K] (Similar to above) (YouTube)
*[https://www.youtube.com/channel/UC_3n6GTFuC4tTAojueLBTHg/playlists Manufacturer and other demos in 4K] (YouTube)
*[http://www.imaging-resource.com/news/2014/11/19/samsung-nx1-4k-video-samples-and-new-full-res-frame-grabs-available-for-do Imaging Resource 4K Samples] ''(thanks @Karnis)''
*[https://www.youtube.com/channel/UCve7_yAZHFNipzeAGBI5t9g/videos The HDR Channel] (YouTube)
*[https://www.youtube.com/channel/UC4CAxaO75mfkPr3GRiSGE_w/videos 8K World] (YouTube)
*[https://x265.com/hevc-video-files/ x265 HEVC Samples]
*[http://www.evosiastudios.com/category/portfolio/films/ Evosia Studios] (several beautiful 1080p to 4K films)
*[http://www.libde265.org/downloads-videos/ libde265] (1080p to maxed-out 4K samples) ''(thanks @Martijn)''
*[https://www.youtube.com/user/martinheck1/videos Timestorm Films] (4K to 8K videos)
*[http://samples.mplayerhq.hu/ MplayerHQ's library] (many clips)
::{{note|<code>http://samples.mplayerhq.hu</code> can even be added to Kodi as a video source, for easy loading, if you have a fast enough connection.}}
*[https://www.pc-magazin.de/ratgeber/hdr-tv-testfilm-testbild-kostenlos-download-3195250.html PC-Magazin.de/Ratgeber/hdr-tv-testfilm-testbild] (4K HDR and SDR test patterns with German descriptions)
*[https://tdarr.io/samples/ Tdarr samples](2000+ 240p-4K samples)

== Library samples ==
=== Fake movie library ===
:A zipped collection of 1,000 empty movie files, with NFO files, poster, and fanart for each entry. Various movies from different years, including sequels/sets, remakes, movies named the same but unrelated, various genres, and so on. Useful for testing things like library scanning speed, library navigation, filtering, etc.

:* https://www.dropbox.com/s/llciqryeqqk4t70/Test%20video%20library.zip?dl=0

=== Fake TVShow library ===
:A zipped collection of 1,273 empty tvshow files and various show artwork. Contains 20 popular TVShows.

:* https://github.com/zag2me/Kodi-Test-Sample-Media

=== Music library ===
: Just the one album for now but hope to increase this over time. It's a complete album in MP3 format, tagged with Musicbrainz Picard ID3v2.3 (ID3v1 ID3v2.3) with extra genre, comment and composer tags for testing. Coverart is also included as a folder.jpg file. The album is licensed "Attribution-ShareAlike 3.0 Unported Creative Commons license" by the artist. You can download or pay for the album here if you like it. http://hungrylucy.com/album/pulse-of-the-earth

:* https://www.dropbox.com/s/rk8ue5fs49v5pnm/Creative_Commons_Music.zip?dl=0

=== Fake Sports TV Show library ===
: Here is a fake sports TV show library for use with the Kodi sports scraper. It includes a number of sports folders broken down into seasons and then events. This should work nicely with the current Sports TV scraper on the Kodi forums.

:* https://www.thesportsdb.com/Sports_fake_video_files.zip

=== Homebrew Games and Game ROMs ===
: These are locations to find a number of freely licensed "homebrew" games for classic consoles and stand-alone games that can be downloaded for testing with Kodi's upcoming [[Games|RetroRlayer]] feature. They include some homebrew games for NES, SNES, and GameBoy emulators, as well as a few homebrew game titles, such as; Cannonball, xrick, ChaiLove games and Lutro games.

:* https://github.com/OpenEmu/OpenEmu-Update/tree/master/Homebrew
:* https://buildbot.libretro.com/assets/cores/

== See also ==
* [[Video levels and color space]]

[[Category:Troubleshooting]]

HOW-TO:Video addon

2019-10-16T08:11:35Z

Zag: Add video streaming section notes

{{mininav|[[Development]]|[[Add-on development]]|[[Python development]]}}
<br />

=Introduction=
This tutorial will explain how to write your first Kodi/XBMC video plugin Add-on<br />

=Tools=
Assuming you have already followed the Hello World Add-on you will have a text editor already setup. Since we are dealing with videos this time its probably a good idea to have a video player setup. We recommend another great open source project for this

- VLC http://www.videolan.org/vlc/

=Installing=
For this example we will use 2 nice basic video Add-on tutorials You can find the source-code here:

https://github.com/romanvm/plugin.video.example

You can either download as a zip and install both of these inside the kodi GUI from the install from zip feature. Or extract the zip into your userdata/add-ons folder.

=Testing=
You can first give the add-on a test run by going to:
System >> Add-Ons >> Enabled Add-Ons >> Video Add-Ons >> Example Kodi video Plugin. You should now be able to watch some test videos hosted from an internet web server.

[[File:Videotutorial1.jpg]]

=Explanation=
So whats happening in this add-on?

Basically the Add-on is checking a website for the hosted videos. In this example we are directly linking to the videos, but there are possibilities for dynamic content and scraping of just about any online source

Once the video link is sent to Kodi, our video player takes over and buffers, then plays the video just like any other media.

=Structure=
main.py <-- This is the actual python code for your Add-On

addon.xml <-- This is the Add-Ons metadata

icon.png <-- A PNG icon for the add-on. It can be 256x256 or 512x512 pixels big. Try to make it look nice!

Readme.md <-- The readme text file with a description of the Add-on and install instructions. This shows on the front of the GitHub page and helps users to understand your Add-on before downloading.

=The Code=
So now we come to the actual Add-On code, this is where most of your Add-on is written and is a simple text file containing python code.

First we initialize the Add-on and import and bits we need

<syntaxhighlight lang="python" enclose="div">
import sys
from urlparse import parse_qsl
import xbmcgui
import xbmcplugin
</syntaxhighlight>

Now we do something else...

<syntaxhighlight lang="python" enclose="div">
# Get the plugin url in plugin:// notation.
__url__ = sys.argv[0]
# Get the plugin handle as an integer number.
__handle__ = int(sys.argv[1])
</syntaxhighlight>

Here we use a fixed set of properties simply for demonstrating purposes. In a "real life" plugin you will need to get info and links to video files/streams from some web-site or online service.

<syntaxhighlight lang="python" enclose="div">
VIDEOS = {'Animals': [{'name': 'Crab',
'thumb': 'http://www.vidsplay.com/vids/crab.jpg',
'video': 'http://www.vidsplay.com/vids/crab.mp4',
'genre': 'Animals'},
{'name': 'Alligator',
'thumb': 'http://www.vidsplay.com/vids/alligator.jpg',
'video': 'http://www.vidsplay.com/vids/alligator.mp4',
'genre': 'Animals'},
{'name': 'Turtle',
'thumb': 'http://www.vidsplay.com/vids/turtle.jpg',
'video': 'http://www.vidsplay.com/vids/turtle.mp4',
'genre': 'Animals'}
],
'Cars': [{'name': 'Postal Truck',
'thumb': 'http://www.vidsplay.com/vids/us_postal.jpg',
'video': 'http://www.vidsplay.com/vids/us_postal.mp4',
'genre': 'Cars'},
{'name': 'Traffic',
'thumb': 'http://www.vidsplay.com/vids/traffic1.jpg',
'video': 'http://www.vidsplay.com/vids/traffic1.avi',
'genre': 'Cars'},
{'name': 'Traffic Arrows',
'thumb': 'http://www.vidsplay.com/vids/traffic_arrows.jpg',
'video': 'http://www.vidsplay.com/vids/traffic_arrows.mp4',
'genre': 'Cars'}
],
'Food': [{'name': 'Chicken',
'thumb': 'http://www.vidsplay.com/vids/chicken.jpg',
'video': 'http://www.vidsplay.com/vids/bbqchicken.mp4',
'genre': 'Food'},
{'name': 'Hamburger',
'thumb': 'http://www.vidsplay.com/vids/hamburger.jpg',
'video': 'http://www.vidsplay.com/vids/hamburger.mp4',
'genre': 'Food'},
{'name': 'Pizza',
'thumb': 'http://www.vidsplay.com/vids/pizza.jpg',
'video': 'http://www.vidsplay.com/vids/pizza.mp4',
'genre': 'Food'}
]}
</syntaxhighlight>
And now we define something else...

<syntaxhighlight lang="python" enclose="div">
def get_categories():
"""
Get the list of video categories.
Here you can insert some parsing code that retrieves
the list of video categories (e.g. 'Movies', 'TV-shows', 'Documentaries' etc.)
from some site or server.
:return: list
"""
return VIDEOS.keys()
</syntaxhighlight>
And now we define something else...

<syntaxhighlight lang="python" enclose="div">
def get_videos(category):
"""
Get the list of videofiles/streams.
Here you can insert some parsing code that retrieves
the list of videostreams in a given category from some site or server.
:param category: str
:return: list
"""
return VIDEOS[category]
</syntaxhighlight>
And now we define the list of categories

<syntaxhighlight lang="python" enclose="div">
def list_categories():
"""
Create the list of video categories in the Kodi interface.
:return: None
"""
# Get video categories
categories = get_categories()
# Create a list for our items.
listing = []
# Iterate through categories
for category in categories:
# Create a list item with a text label and a thumbnail image.
list_item = xbmcgui.ListItem(label=category, thumbnailImage=VIDEOS[category][0]['thumb'])
# Set a fanart image for the list item.
# Here we use the same image as the thumbnail for simplicity's sake.
list_item.setProperty('fanart_image', VIDEOS[category][0]['thumb'])
# Set additional info for the list item.
# Here we use a category name for both properties for for simplicity's sake.
# setInfo allows to set various information for an item.
# For available properties see the following link:
# http://mirrors.xbmc.org/docs/python-docs/15.x-isengard/xbmcgui.html#ListItem-setInfo
list_item.setInfo('video', {'title': category, 'genre': category})
# Create a URL for the plugin recursive callback.
# Example: plugin://plugin.video.example/?action=listing&category=Animals
url = '{0}?action=listing&category={1}'.format(__url__, category)
# is_folder = True means that this item opens a sub-list of lower level items.
is_folder = True
# Add our item to the listing as a 3-element tuple.
listing.append((url, list_item, is_folder))
# Add our listing to Kodi.
# Large lists and/or slower systems benefit from adding all items at once via addDirectoryItems
# instead of adding one by ove via addDirectoryItem.
xbmcplugin.addDirectoryItems(__handle__, listing, len(listing))
# Add a sort method for the virtual folder items (alphabetically, ignore articles)
xbmcplugin.addSortMethod(__handle__, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE)
# Finish creating a virtual folder.
xbmcplugin.endOfDirectory(__handle__)
</syntaxhighlight>

And here we list the videos

<syntaxhighlight lang="python" enclose="div">
def list_videos(category):
"""
Create the list of playable videos in the Kodi interface.
:param category: str
:return: None
"""
# Get the list of videos in the category.
videos = get_videos(category)
# Create a list for our items.
listing = []
# Iterate through videos.
for video in videos:
# Create a list item with a text label and a thumbnail image.
list_item = xbmcgui.ListItem(label=video['name'], thumbnailImage=video['thumb'])
# Set a fanart image for the list item.
# Here we use the same image as the thumbnail for simplicity's sake.
list_item.setProperty('fanart_image', video['thumb'])
# Set additional info for the list item.
list_item.setInfo('video', {'title': video['name'], 'genre': video['genre']})
# Set 'IsPlayable' property to 'true'.
# This is mandatory for playable items!
list_item.setProperty('IsPlayable', 'true')
# Create a URL for the plugin recursive callback.
# Example: plugin://plugin.video.example/?action=play&video=http://www.vidsplay.com/vids/crab.mp4
url = '{0}?action=play&video={1}'.format(__url__, video['video'])
# Add the list item to a virtual Kodi folder.
# is_folder = False means that this item won't open any sub-list.
is_folder = False
# Add our item to the listing as a 3-element tuple.
listing.append((url, list_item, is_folder))
# Add our listing to Kodi.
# Large lists and/or slower systems benefit from adding all items at once via addDirectoryItems
# instead of adding one by ove via addDirectoryItem.
xbmcplugin.addDirectoryItems(__handle__, listing, len(listing))
# Add a sort method for the virtual folder items (alphabetically, ignore articles)
xbmcplugin.addSortMethod(__handle__, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE)
# Finish creating a virtual folder.
xbmcplugin.endOfDirectory(__handle__)
</syntaxhighlight>

Now we tell Kodi how to find the video path to play the videos

<syntaxhighlight lang="python" enclose="div">
def play_video(path):
"""
Play a video by the provided path.
:param path: str
:return: None
"""
# Create a playable item with a path to play.
play_item = xbmcgui.ListItem(path=path)
# Pass the item to the Kodi player.
xbmcplugin.setResolvedUrl(__handle__, True, listitem=play_item)
</syntaxhighlight>

This is the router function

<syntaxhighlight lang="python" enclose="div">
def router(paramstring):
"""
Router function that calls other functions
depending on the provided paramstring
:param paramstring:
:return:
"""
# Parse a URL-encoded paramstring to the dictionary of
# {<parameter>: <value>} elements
params = dict(parse_qsl(paramstring[1:]))
# Check the parameters passed to the plugin
if params:
if params['action'] == 'listing':
# Display the list of videos in a provided category.
list_videos(params['category'])
elif params['action'] == 'play':
# Play a video from a provided URL.
play_video(params['video'])
else:
# If the plugin is called from Kodi UI without any parameters,
# display the list of video categories
list_categories()
</syntaxhighlight>

Call the router function

<syntaxhighlight lang="python" enclose="div">
if __name__ == '__main__':
# Call the router function and pass the plugin call parameters to it.
router(sys.argv[2])
</syntaxhighlight>

=Changing the code=

Hopefully by now you have managed to run the Add-On, understand the structure and can see what the code can do. Now lets trying changing it a little!

Since we already have the Add-on installed we can go directly to the Kodi userdata folder and edit the python directly. You can also have Kodi open at this time ready to run the Add-on when required. Just switch between your text editor and Kodi any time.

Now open up the main.py file from your userdata folder and lets change what the text says.

'Cars': [{'name': 'Postal Truck',
'thumb': 'http://www.vidsplay.com/vids/us_postal.jpg',
'video': 'http://www.vidsplay.com/vids/us_postal.mp4',
'genre': 'Cars'},

Try changing some of the links to another jpeg file or hosted online video. Also try to change the genre and see how that effects the view in Kodi.

Click save on your text editor and now try running the Add-On inside Kodi. You should see the new video links and navigation right away.

Congratulations! you've just played an online video from your very own Video Add-on

=Streaming Video=
In addition to this guide, here are some comments from an experienced developer who has worked with streaming video sites:

The docs on codedocs.xyz will help you a lot, way more than any wiki.

https://codedocs.xyz/xbmc/xbmc/

Speaking of docs, the ListItem reference will be most useful, time and time again.

https://codedocs.xyz/xbmc/xbmc/group__python__xbmcgui__listitem.html#gac31a08def90f50295146753353cb9541

Since you're relying on a streaming platform you won't need to do anything particular yourself, you can get away with fetching the data and posting an item with the URL of the video. InputStream.Adaptive configuration might be needed, especially if the videos need DRM.

You can get a lot done with the requests module, depending on the data you're processing. It's fully supported in Kodi, cookie and sessions included.
In short, it's really simple, you:

- get the information you need off the internet (title/URL could suffice for a start);

- you generate items that Kodi will treat as video sources (see xbmcplugin.addDirectoryItem() and xbmcgui.ListItem());

You could also read the sources of plugins such as AsciiDisco's Netflix or Sandmann79's Amazon/AmazonVOD addons.

You can read more in this thread
https://forum.kodi.tv/showthread.php?tid=348328

=Final Thoughts=

Writing a Video Add-on is actually pretty simple once you get the basic structure correct. You can scrape most online sources with Regex, or host your own videos on the web. You can also play youtube clips or vevo videos using some additional easy to use modules.

If you have any questions about this tutorial, feel free to discuss it on our forums here: http://forum.kodi.tv/showthread.php?tid=248774

=Extra info=

Just a reminder...
IMPORTANT!!!!!!! Do not mix tabs and spaces in python

[[Category:Add-on development]]

Music videos

2019-09-24T13:18:04Z

Zag: Add Nfo summary section with link to main article

{{mininav|[[Video library]] {{l2| [[Music library]] }} }}
<section begin="intro" />Kodi has the ability to include Music Videos in the [[Video library|Video]] and [[Music library|Music]] libraries. All scanned music videos will show up in both. Music Videos can also be part of [[Playlists#Party Mode Playlist|Party Mode]] and [[Playlists#Smart Playlists|Smart Playlists]]. Playlists containing both music and music videos should be stored in the mixed playlist subfolder under the [[userdata]] folder.<section end="intro" />

== File structure ==

Its important to make use the standard file structure for music videos like so:

C:\Kodi Sources\Mvids\Artist - Title.mkv

All music videos should be in a single folder named exactly as the above examples. NOTE: The space between the hyphen is important!

[[File:Mvids-Structure.jpg]]

== Selecting the source ==

Once you have all your music videos named correctly we can set them up as a source in Kodi

Videos >> Files >> Add Videos >> Browse >> Select your music video folder (in this case "Mvids")

== Selecting the Scraper ==

Now we have the source folder selected we need to set a few options:

Set content >> "Music Videos" >> Choose provider

NOTE: Currently there are no music video scrapers on the official Kodi Repository, but you can find some here on github. Just download as a zip and install from kodis add-on browser manually:

https://github.com/tphoenix/metadata.musicvideos.imvdb

https://github.com/zag2me/metadata.musicvideos.theaudiodb.com

Make sure that user folder names for lookups is unchecked and hit OK, then update library at the next popup.

[[File:Mvids-Config.jpg]]

== Music Video Views ==

Now we have all the music videos imported, we can go and find them from the main menu

Music >> Music Videos >> Title

And now you should see something like this with all the artwork and metadata matched to each video!

[[File:Mvid-View.jpg]]

From here you can browse music videos in many different ways such as by year, title or via the album they were released on.

[[File:Mvid-nodes.jpg]]

This will make it much easier and quicker to find the video you want.

As an added bonus you can also search by director or even the film company that produced it. Its a really nice way of browsing the videos if you like the style of a particular director.

== Video guides ==

{{youtube|n7kYOhiMFiI}}

== Music Video NFO files ==
Just as with other types on content in Kodi, you can override any music video lookup with an NFO file. This can be useful for videos that don't scrape properly or where you just want to manually add metadata and artwork.

Just create a new text file with the nfo extension named the same filename as the music video so for example:

C:\Media\MViDS\Abba - Dancing Queen.mkv
C:\Media\MViDS\Abba - Dancing Queen.nfo

And edit the .nfo with a text editor in the following syntax.

{{collapse top| Music Video nfo file (click 'expand' to view)}}
<syntaxhighlight lang="xml" line='line'>
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<musicvideo>
<title>Dancing Queen</title>
<userrating>0</userrating>
<top250>0</top250>
<track>3</track>
<album>Arrival</album>
<outline></outline>
<plot>Dancing Queen est un des tubes emblématiques de l'ère disco produits par le groupe suédois ABBA en 1976. Ce tube connaît un regain de popularité en 1994 lors de la sortie de Priscilla, folle du désert, et fait « presque » partie de la distribution du film Muriel.
Le groupe a également enregistré une version espagnole de ce titre, La reina del baile, pour le marché d'Amérique latine. On peut retrouver ces versions en espagnol des succès de ABBA sur l'abum Oro. Le 18 juin 1976, ABBA a interprété cette chanson lors d'un spectacle télévisé organisé en l'honneur du roi Charles XVI Gustave de Suède, qui venait de se marier. Le titre sera repris en 2011 par Glee dans la saison 2, épisode 20.</plot>
<tagline></tagline>
<runtime>2</runtime>
<thumb preview="https://www.theaudiodb.com/images/media/album/thumb/arrival-4ee244732bbde.jpg/preview">https://www.theaudiodb.com/images/media/album/thumb/arrival-4ee244732bbde.jpg</thumb>
<thumb preview="https://assets.fanart.tv/preview/music/d87e52c5-bb8d-4da8-b941-9f4928627dc8/albumcover/arrival-548ab7a698b49.jpg">https://assets.fanart.tv/fanart/music/d87e52c5-bb8d-4da8-b941-9f4928627dc8/albumcover/arrival-548ab7a698b49.jpg</thumb>
<mpaa></mpaa>
<playcount>0</playcount>
<lastplayed></lastplayed>
<id></id>
<genre>Pop</genre>
<director>John Smith</director>
<premiered>1976-01-01</premiered>
<year>1976</year>
<status></status>
<code></code>
<aired></aired>
<studio>Studio 54</studio>
<trailer></trailer>
<fileinfo>
<streamdetails>
<video>
<codec>hevc</codec>
<aspect>1.792230</aspect>
<width>716</width>
<height>568</height>
<durationinseconds>143</durationinseconds>
<stereomode></stereomode>
</video>
<audio>
<codec>ac3</codec>
<language>eng</language>
<channels>2</channels>
</audio>
</streamdetails>
</fileinfo>
<artist>ABBA</artist>
<resume>
<position>0.000000</position>
<total>0.000000</total>
</resume>
<dateadded>2018-09-10 09:46:06</dateadded>
</musicvideo>
</syntaxhighlight>
{{collapse bottom}}

Full Wiki article here: https://kodi.wiki/view/NFO_files/Music_videos

== 3rd Party Apps ==
There is a good 3rd party app that can help create NFO files

[[File:1f9fmvid nfo creator.jpg]]

Download = https://archive.codeplex.com/?p=popatopdad

== Known Issues ==
- Music Videos with apostrophes in the artist or song name will not currently work with the XML scraper

- Music Videos that do not have an entry on MusicBrainz or TheAudioDB website will not work with the current scraper. Solution is to add them to Musicbrainz and then import on TheAudioDB if possible.

[[Category:Video library]]
[[Category:Music library]]
[[Category:Manual]]

Music videos

2019-09-24T13:07:10Z

Zag: Add 3rd Party Mvid App section

File:1f9fmvid nfo creator.jpg

2019-09-24T13:05:00Z

Zag:

Music videos

2019-09-24T13:03:20Z

Zag: Add known issues section

Music tagging

2019-01-12T12:55:40Z

Zag: /* MusicBrainz */ Add info about tagging options in Picard

{{MusicLibraryCreate}}

= Introduction =
This page, Music File and Tagging, provides the following information:

*How the Music section differs from the Video section of {{kodi}}
*How to organise your music files
*The recommended method for tagging your music files
*Explanation of some commonly misunderstood Music File Tags
*The Audio Files and Tags that {{kodi}} reads and uses

= Understanding the Music Library =
{{Red|'''The Music section of {{kodi}} has many differences to the Video section of {{kodi}}. It is important that you read this section to ensure your music and artwork are correctly scraped and displayed.'''}}
<br />

<section begin="understanding" />It is important to understand the fundamental difference between video library operation and the music library operation:
*The video library is based on using the filenames to obtain online data. If the video files are incorrectly named, then there are no scraper results and there will be no library entry.
*'''The music library is based on scanning tags embedded in the music files.''' It ignores the folder structure and file names you have created to store your music files. Basic and correct tagging is essential to ensure the library is populated correctly. Having slight variations in the tags for artist and album names could mean duplicated and unwanted entries.<section end="understanding" />
<br />

= Folder and File Structure =
Although {{kodi}} ignores the folder structure and the names of the folders and files, the structure of your folders is important as it affects the operation of other functions such as Import/Export, nfo files and Artwork. For example, if you have all your music files in one folder (which is possible), then you lose the ability to use local nfo files, local artwork, and the import/export module will not function correctly.

For this reason, {{kodi}} recommends the use of the following structure.

== Files ==
Remember that {{kodi}} does not extract any information from the filename. The only purpose the file name serves is to provide {{kodi}} a unique id to locate the file.

The name you use for your files is your choice, but it is important that they are:
#Consistent
#Make sense

Example file names:

*Using the simple Song Name only = ''Everybody Wants to Rule the World.flac'' <br />
*Using a more complex combination of Artist-Album-Song = ''Madonna-True Blue-Open Your Heart.flac''

If you would like to use track numbers in the file name, then ensure you include the disc number, even if there is only one disc. eg
*''0102 Everybody Wants to Rule the World.flac'' or ''D01T02 Everybody Wants to Rule the World.flac''
*''Madonna-True Blue-0106 Open Your Heart.flac'' or ''Madonna-True Blue-D01T06 Open Your Heart.flac''

Where 0102 = Disc 01 and Track 02

== Folders ==
Folders are used as follows:
#Album folders - Used to group '''songs''' from the same album into one folder
#Artist folders- Used to group '''albums''' from the same artist into one folder
#Source folder- Used to group '''Collections''' into one folder. (see next section)

The following is a typical recommended structure:

f:\ ....................................(root)
|__Artist Music .......................(source folder)
| |__ Madonna ........................(artist folder)
| | |__ Beautiful Stranger (1999) ..(album folder)
| | | |__ Song 1
| | | |__ Song 2
| | | |__ Song 3 etc
| | |__ Bedtime Stories (1994) .....(album folder)
| | | |__ Song 1
| | | |__ Song 2
| | | |__ Song 3 etc
| | |__ Like A Prayer (1989) .......(album folder)
| | | |__ Song 1
| | | |__ Song 2
| | | |__ Song 3 etc
| |__ Simply Red .....................(artist folder)
| |__ Picture Book (1985) ........(album folder)
| |__ Song 1
| |__ Song 2
| |__ Song 3 etc
|
|__Compilations .......................(Source)
| |__ Essential Eighties .............(album folder)
| | |__ Song 1
| | |__ Song 2
| | |__ Song 3 etc
| |__ 100% Hits- Best of 2005 ........(album folder)
| |__ Song 1
| |__ Song 2
| |__ Song 3 etc
|
|__Classical ..........................(Source)
|
|__Audio Books ........................(Source)

== Sources ==
A source folder contains your media collection- in this case Music. This folder is then set as a Source in {{kodi}} which enables {{kodi}} to access your Music. (remember, Kodi does not know where your media is until you tell it)

In the Video section of Kodi, you would set one, or more, sources for Movies, TV Shows, Music Videos, Home Movies etc. The Music section oparates along the same principle.

As an example, you would save your music folders into separate Sources for the following:
*'''Single Artist type Albums '''
**These are albums released by a single artist or band
**This source will contain the Artist / Album / Song structure
**Examples- Kate Bush, Kylie Minogue, Tears for Fears etc
*'''Various Artists or Compilation Albums'''
**These are albums that contain songs from many different artists or bands.
**As there is multiple artists, there is no Artist folder. This source would contain the Album / Song structure.
**Examples- 2017 Grammy Nominees, So Fresh: Hits of 2016, Open Space: The Classic Chillout Album etc
*'''Classical Music'''
**Albums released by a single Composer. It is a separation from the main stream music in the Single Artist Source, which aids in better sorting in Kodi
**This source would contain the Artist / Album / Song structure, assuming single composer type albums, and groups all classical music in one source
**Examples- Vaughan Williams, Rachmaninov, Mozart etc

The idea is to group similar types of albums. This is not a requirement, and Kodi will still function if you grouped your music into a single source. It is a best practice guide which overcomes some hurdles with local files for compilation and collaboration type albums. These hurdles will no longer be an issue from v18 onwards.

Setting and Scanning of Sources is covered in detail in the next step of the guide.

= Ripping CD's =
{{#lst:Ripping CDs|intro}}

There is no requirement to use this native {{Kodi}} CD Ripper. If you are comfortable using other ripping software, then we recommend you continue using that software. It makes no difference to {{kodi}} which software was used.

{{main|Ripping CDs}}

= Tagging =
Ever wonder how your music player always knows the name of the song, album, artist and track number of the music you play? This information comes from metadata embedded in the music file. If you purchased your music from an online store, then that store would have embedded the metadata in the file. If you ripped your own music, then the ripping software would have embedded the data into the file, probably without you even knowing. It is not uncommon that only minimal metadata is embedded, but this works very well on simple music players and is a convenient solution to sorting your library on these players.
<br /><br />
{{kodi}} also makes use of this embedded metadata. {{kodi}}, being an advanced and feature rich player, requires a greater precision in the embedded tags. Any slight variance in, for example, the Album name between the tracks from the same album will see multiple entries in the library for that Album. Same with Artists. It is not uncommon to have a single album split into three similarly named albums. It is for this reason that there is a separation of the Scanning and Scraping processes for Music. The initial scan allows you to find and correct errors in tagging, before scraping. Failing to do that will create an unmanageable library.
<br /><br />
Example of errors in tagging, which will cause duplicated entries in the library...

{|class="prettytable"
!Similar Name 1 || Similar Name 2 || Note
|-
|György Ligeti || Gyorgy Ligeti || Accented and unaccented names will create duplicate entries
|-
|The Best of || The Very Best Of || Inconsistent naming between songs of the same album and/or artist will cause duplicated entries
|-
|Madonna || Madonnna || Spelling mistakes will cause duplicated entries for albums and/or artists
|-
|Sting || Sting and The Police || Seen as two separate and unrelated Artists
|}

The easiest method to comprehensively tag your music files is with MusicBrainz Picard.

As {{kodi}} scans your music collection, it copies the data contained in those tags into the {{kodi}} music database. The benefits of this are:
*Once the scan is complete, the tags are not accessed again
*All information is now obtained from the database. This has the benefit of dramatically increasing efficency and speed when navigating the library.
*Now that a database entry exists, you are able to scrape additional information from online sources. This is covered later in the guide.

== MusicBrainz ==
'''{{kodi}} has strong support for MusicBrainz tagging. It is highly recommended that users tag their music files using MusicBrainz picard.'''

'''MusicBrainz''' is an open source music encyclopedia that collects music metadata and makes it available to the public. MusicBrainz has a database that, as of Sept 2017, [https://musicbrainz.org/statistics consists of over 1,258,860 Artists, over 1,866,600 albums and over 17,846,800 recordings].

'''MusicBrainz Picard''' is the music file tagger software that can access the MusicBrainz database to locate metadata to embed into your music files. It is recommended that your music collection is correctly tagged using the tagging software [https://picard.musicbrainz.org/ MusicBrainz Picard]. This is a free download. There are other Taggers that are able to access the MusicBraniz database, but Picard seems to be friendliest to use.

Below is a screenshot of the main screen of the Picard software. A brief description of the layout as follows.

*Top Left Box- Folder listing of your music collection
*Top Centre Box- Albums are dragged and dropped here in preparation for matching and tagging. Pressing ''Lookup'' (greyed out) will commence the lookup process
*Top Right Box- Matching albums are displayed here and your songs are overlayed. In the screenshot, songs 01, 08 and 09 have been matched to the suggested album. If all songs match and you agree the correct album was located, simply pressing Save will tag the album with the tags displayed in the Bottom Tag Box.
*Bottom Tag Box - Selecting a song from the Top Right Box will display all available tag fields (left column), the current tags in the music file (Original Value column) and the MusicBrainz tags to be embedded in the music file (right column).

It is important to note that a lot of music is distributed with only the basic metadata embedded, as can be clearly seen in the screenshot below. (Original Value column)

The example in the image below shows the following:
*Most tags are missing (original value column)
*The top three yellow entries are incorrect (original value column) and the corrections are in the right column
*The green entries in the right column indicate new tags to be embedded
*The black entries at the bottom of the list indicate no change to the existing tags as they are correct.

Although {{kodi}} will populate the library with those minimal tags, the errors in those tags would create havoc in the library.

Further information and guides can be found at the [https://picard.musicbrainz.org/ MusicBrainz Picard] site.

[[File:MusicBrainzPicard01.jpg|1300px|centre]]

Although Picard is very easy to use, you must avoid blindly accepting everything offered by the software. It is important that you confirm the correct album was located. Due to the global nature of the database, there are many releases for a single album. These releases differ between countries, usually due to copyright requirements. This may lead you to inadvertendly select the incorrect release for your album, even though it is named exactly the same. The differences between releases may be as simple as different song ordering or the inclusion of additional bonus tracks.

For the best tagging experience, it is important to set the correct options in Picard, particularly the "Clear Existing Tags" option in settings. This option means that any old tags that may cause issues are wiped, preserving only the good, clean musicbrainz tagging.

[[File:Picard options.jpg|400px|centre]]

Once the music files are tagged, it is important to avoid modifying the MusicBrainz tags unless you clearly understand the relationship of the MBID's and the other related tags. For example, embedding MBID tags, but then editing the Artist tag or Album Artist tag will result in incorrect entries in the library.

:'''''See: [https://musicbrainz.org/ MusicBrainz Website]'''''
:'''''See: [https://picard.musicbrainz.org/ MusicBrainz Picard Software]'''''

----
<center>{{red|'''The remainder of this page deals with special use cases or provides information for technical interest and reference only. It can be safely disregarded if these do not apply to you'''}}</center>
----

<div style="{{linear-gradient|left|#f5d3ff, #12b2e7}}">{{next|[[Adding_music_to_the_library|Scanning Music Into Library]]}} </div>

== Cue Sheets ==
{{#lst:Cue_sheets|intro}}

{{kodi}} does provide basic support for using cue sheets to define individual tracks when an entire CD has been ripped into a single music file. However the information provided by the cue sheet standard is much more limited than that of standard tagging, hence to enjoy the full music library features it is recommended that tracks are ripped into separate files and fully tagged.
<br />
{{red|If you do not use Cue Sheets you can safely move onto the next step.}}
<br />
;{{see also|Cue_sheets}}

= Streams =
{{#lst:Internet_video_and_audio_streams|intro}}

;{{see also|Internet_video_and_audio_streams}}

= Technical Explanation: File tags =
For many categories, such as genres and artists, {{kodi}} supports multiple values in the one field. By default it uses the character sequence " / " to divide the entry into multiple values. This divider may be changed via [[advancedsettings.xml]].

== Resolving Compilations and Multiple Artists ==
{{kodi}} reads the ''Album Artist'' tag in ID3, Ogg, APE and MP4 tags and uses it if available to assign an artist to the album (independently of the track's artist information). This is the "Album Artist" tag (in ID3 this is represented by the "TPE2" tag; in vorbiscomment (ogg) files "ALBUMARTIST", "ALBUM ARTIST" and "ENSEMBLE" are all supported). Multiple artists for either a track or album artist can be specified in "Artist1 / Artist2 / Artist3" format.

If no ''Album Artist'' tag exists, {{kodi}} will use the first (primary) artist from the tracks as the ''Album Artist''. Essentially we do a string comparison of all the track artists, and assign the common artists as the ''Album artist''. This is generally the TPE1 tag in ID3.

As many users don't yet use the ''Album Artist'' tag, {{kodi}} has an additional filter system for identifying compilation albums, where each track normally has a different artist. As {{kodi}} scans a folder, it does the following:
# Identifies albums based on ''Album'' name alone in the folder and groups the songs that have the same ''Album'' name together as an album.
# Runs through each album's assigned songs. If there is 2 or more tracks with the same ''Track'' number, the group of songs must come from 2 or more albums, so the ''Album'' name is ruled out as a possible compilation.
# If any of the songs assigned to the ''Album'' name have an ''Album Artist'' tag, then {{kodi}} assumes the user knows what they're doing, and this album is also ruled out from being a compilation.
# If two or more songs assigned to the ''Album'' name then have different primary artists, then the ''Album'' name is considered to be a group of songs from a compilation, and the ''Various Artists''" tag is assigned as the album artist.
# Otherwise, if all the songs have the same primary artist but don't have the same full artist list (eg a song or two has an additional artist) then the album is assigned the primary artist as it's ''Album Artist'', and we assume the additional artists are guest artists.

== Roles Tags ==
WIP / TBA

== Ratings in ID3 tags ==
Ratings in ID3 tags are read via the POPM field, and (if this doesn't exist) in a custom (TXXX) field named "RATING". For the RATING field, we accept 1-5 as valid ratings. For the POPM field things are more complicated, as there is no established standard in place. We currently most closely respect what Mediamonkey does, and also have some support for what Windows Media Player 11 does. The POPM tag takes a value from 0..255, with 0 meaning no rating, 1 the worst, and 255 the best. We currently map these as follows:

{| class="prettytable"
|-
!'''POPM value''' || '''Star rating'''
|-
|0 ||
|-
|1 || '''*''' This is a special case for Windows Media Player
|-
| 2-8 ||
|-
|9-49 || '''*'''
|-
|50-113 ||'''**'''
|-
|114-167 || '''***'''
|-
|168-218 || '''****'''
|-
|219-255 ||'''*****'''
|}

= Audio Formats & Tags =

== Supported Audio Formats ==
Although the list of playable formats is quite comprehensive, it is not accurate to say that every {{kodi}} installation will play every format. The ability to play some of the more obscure formats will depend upon the version of {{kodi}} and the operating system in use. Some formats will require the installation of add-ons.

{{#lst:Advancedsettings.xml|musicextensions}}

;{{See also|Advancedsettings.xml}}

== Supported Metadata Containers ==
The following metadata containers are supported by {{kodi}}

{| class="prettytable"
|-
! Metadata Container || Note
|-
|[[wikipedia:APEv2 tag|APEv2 tag]] ||
|-
|[[wikipedia:Advanced_Systems_Format|ASF]] ||
|-
|Generic Tag || A generic tag for basic data from other odd file types
|-
|[[wikipedia:ID3|ID3]] || v1, v2.3 and v2.4
|-
|[[wikipedia:MPEG-4 Part 14#Metadata|MP4]] ||
|-
|[https://xiph.org/ Xiph.org] || Vorbis Comments
|}

== Common File & Tag Combination ==
You will notice that not all the tags listed in the section ''Supported Audio Formats'' above are listed in the following table. Those formats that are ommitted do not have provision to support embedded tags. If your collection contains any of these unsupported formats, you will be unable to scan the music into the library. Your options are:
#Convert your audio file to a supported format and tag using MusicBrainz Picard. (recommended)
#Access your music via the File Manager or via File View

{{kodi}} supports the following common Audio File and Tag Formats

{| class="wikitable sortable" style="text-align:center;"
|-
!| Metadata container
!| Additional Filename extensions
|-
| [[wikipedia:APEv2 tag|APEv2 tag]] || ape, mp3, aac, wv, mpc
|-
| [[wikipedia:Advanced_Systems_Format|ASF]] || asf, wmv, wma
|-
| Generic Tag || it, mod, module, nst, wow, s3m, xm
|-
| [[wikipedia:ID3|ID3 v1]] || mp3, aac
|-
| [[wikipedia:ID3|ID3 v2]] || mp3, aac, tta, aif, aiff, wav, flac
|-
| iTunes [[wikipedia:MPEG-4 Part 14#Metadata|MP4]] || .3g2 .m4a .m4b .m4p .m4r .m4v .mp4
|-
|[https://xiph.org/ Xiph.org] || flac, oga, ogg, opus
|}

Note:
*FLAC files- xiph tags override id3v2 tags
*mp3 files can have either id3 or APE tags
*mka, dsf, dff - ID3v2 format read but are handled by ffmpeg tag reader and it does not support all tags from IDE standard)

== Tags {{kodi}} reads ==
{{kodi}} will scan the following tags embedded in the music file. The column ''{{kodi}} Version'' indicates the version of {{kodi}} that the tag was introduced, and will work in subsequent versions.

<section begin="TagTable" />
{| class="wikitable sortable" style="text-align:center;"
|-
! style="text-align:left;"| {{kodi}} Version
! Vorbis (.Flac)
! ID3v2 (.mp3)
! APE
! MP4
! ASF
|-
|v16
|ARTIST
|TPE1
|ARTIST
|\251ART
|Author
|-
|v16
|ARTISTS
|ARTISTS
|ARTISTS
| ----:com.apple.iTunes:ARTISTS
|
|-
|v16
|ALBUMARTIST or ALBUM ARTIST
|TPE2 OR ALBUMARTIST or ALBUM ARTIST
|ALBUMARTIST or ALBUM ARTIST
|aART
|WM/AlbumArtist
|-
|v16
|ALBUMARTISTS or ALBUM ARTISTS
|ALBUMARTISTS or ALBUM ARTISTS
|ALBUMARTISTS or ALBUM ARTISTS
| ----:com.apple.iTunes:ALBUMARTISTS
|
|-
|v16
|ALBUM
|TALB
|ALBUM
|\251alb
|WM/AlbumTitle
|-
|v16
|TITLE
|TIT2
|TITLE
|\251nam
|
|-
|v16
|TRACKNUMBER
|TRCK
|TRACKNUMBER or TRACK
|trkn
|WM/TrackNumber or WM/Track
|-
|v16
|DISCNUMBER
|TPOS
|DISCNUMBER or DISC
|disk
|WM/PartOfSet
|-
|v16
|YEAR
|TYER
|YEAR
|\251day
|WM/Year
|-
|v16
|DATE
|TDRC, TDRL
|DATE
|
|
|-
|v16
|GENRE
|TCON
|GENRE
|\251gen
|WM/Genre
|-
|v16
|MOOD
|TMOO OR TXXX:MOOD
|MOOD
| ----:com.apple.iTunes:MOOD
|WM/Mood
|-
|v16
|COMMENT
|COMM
|COMMENT
|\251cmt
|(COMMENT)
|-
|v16
|CUESHEET
|
|CUESHEET
|
|
|-
|v16
|COMPILATION
|TCMP
|COMPILATION
|cpil
|
|-
|v16
|LYRICS
|USLT
|LYRICS
|
|
|-
|v16
|REPLAYGAIN_TRACK_GAIN
|REPLAYGAIN_TRACK_GAIN
|REPLAYGAIN_TRACK_GAIN
| ----:com.apple.iTunes:replaygain_track_gain
|replaygain_track_gain
|-
|v16
|REPLAYGAIN_ALBUM_GAIN
|REPLAYGAIN_ALBUM_GAIN
|REPLAYGAIN_ALBUM_GAIN
| ----:com.apple.iTunes:replaygain_album_gain
|replaygain_album_gain
|-
|v16
|REPLAYGAIN_TRACK_PEAK
|REPLAYGAIN_TRACK_PEAK
|REPLAYGAIN_TRACK_PEAK
| ----:com.apple.iTunes:replaygain_track_peak
|replaygain_track_peak
|-
|v16
|REPLAYGAIN_ALBUM_PEAK
|REPLAYGAIN_ALBUM_PEAK
|REPLAYGAIN_ALBUM_PEAK
| ----:com.apple.iTunes:replaygain_album_peak
|replaygain_album_peak
|-
|v16
|REPLAYGAIN_ALBUM_PEAK
|REPLAYGAIN_ALBUM_PEAK
|REPLAYGAIN_ALBUM_PEAK
| ----:com.apple.iTunes:replaygain_album_peak
|replaygain_album_peak
|-
|v16
|MUSICBRAINZ_ARTISTID
|MUSICBRAINZ ARTIST ID
|MUSICBRAINZ_ARTISTID
| ----:com.apple.iTunes:MusicBrainz Artist Id
|MusicBrainz/Artist Id
|-
|v16
|MUSICBRAINZ_ALBUMARTISTID
|MUSICBRAINZ ALBUM ARTIST ID
|MUSICBRAINZ_ALBUMARTISTID
| ----:com.apple.iTunes:MusicBrainz Album Artist Id
|MusicBrainz/Album Artist Id
|-
|v16
|MUSICBRAINZ_ALBUMARTIST
|MUSICBRAINZ ALBUM ARTIST
|MUSICBRAINZ_ALBUMARTIST
| ----:com.apple.iTunes:MusicBrainz Album Artist
|MusicBrainz/Album Artist
|-
|v16
|MUSICBRAINZ_ALBUMID
|MUSICBRAINZ ALBUM ID
|MUSICBRAINZ_ALBUMID
| ----:com.apple.iTunes:MusicBrainz Album Id
|MusicBrainz/Album Id
|-
|v16
|MUSICBRAINZ_TRACKID
|UFID
|MUSICBRAINZ_TRACKID
| ----:com.apple.iTunes:MusicBrainz Track Id
|
|-
|v16
|RATING
|POPM
|
|
|
|-
|v16
|METADATA_BLOCK_PICTURE or COVERART or COVERARTMIME
|APIC
|
|covr
|WM/Picture
|-
|v17
|COMPOSER
|TCOM
|COMPOSER
|\251wrt
|WM/Composer
|-
|v17
|CONDUCTOR
|TPE3
|CONDUCTOR
| ----:com.apple.iTunes:CONDUCTOR
|WM/Conductor
|-
|v17
|LYRICIST
|TEXT
|LYRICIST
| ----:com.apple.iTunes:LYRICIST
|WM/Writer
|-
|v17
|REMIXER or MIXARTIST
|TPE4
|REMIXER or MIXARTIST
| ----:com.apple.iTunes:REMIXER
|WM/ModifiedBy
|-
|v17
|ENSEMBLE
|(TIPL) or TXXX:Ensemble
|ENSEMBLE
|
|
|-
|v17
|ARRANGER
|(TIPL)
|ARRANGER
|
|
|-
|v17
|ENGINEER
|(TIPL)
|ENGINEER
| ----:com.apple.iTunes:ENGINEER
|WM/Engineer
|-
|v17
|PRODUCER
|(TIPL)
|PRODUCER
| ----:com.apple.iTunes:PRODUCER
|WM/Producer
|-
|v17
|DJMIXER
|(TIPL)
|DJMIXER
| ----:com.apple.iTunes:DJMIXER
|WM/DJMixer
|-
|v17
|MIXER
|(TIPL)
|MIXER
| ----:com.apple.iTunes:MIXER
|WM/Mixer
|-
|v17
|PERFORMER
|TMCL
|PERFORMER
|
|
|
|-
|v17
|LABEL
|TPUB
|LABEL
| ----:com.apple.iTunes:LABEL
|WM/Publisher
|-
|v17
|RELEASETYPE
|MUSICBRAINZ ALBUM TYPE
|MUSICBRAINZ_ALBUMTYPE
| ---:com.apple.iTunes:MusicBrainz Album Type
|MusicBrainz/Album Type
|}
<section end="TagTable" />

{{Top}}

<div style="{{linear-gradient|left|#f5d3ff, #12b2e7}}">{{next|[[Adding_music_to_the_library|Scanning Music Into Library]]}} </div>

{{updated|17}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Karellen]]
[[Category:First time user]]
[[Category:Music library]]
[[Category:Advanced topics]]
[[Category:Quick Start Guide]]

{{DISPLAYTITLE:Music Files & Tagging}}

File:Picard options.jpg

2019-01-12T12:52:48Z

Zag:

HOW-TO:Estuary Modification

2018-07-21T14:01:18Z

Zag: Add New view Tutorial

==Introduction==
Estuary is Kodi's default skin, so it makes a good example of how to get start with editing a skin

[[File:Estuary-logo.png]]

== Setting up a developer environment for skinning ==
First thing we need to do is setup a simple skin development environment:

To get the most out of it you'll need to either make a new keymap.xml or add this to your existing one.

<keymap>
<global>
<keyboard>
<F5>XBMC.ReloadSkin()</F5>
<F7>Notification(Testing 123,Hello world)</F7>
<F8>Skin.ToggleDebug()</F8>
</keyboard>
</global>
</keymap>

[[File:Keymap_xml.jpg]]

You will need to copy this keymap.xml file into the Kodi userdata folder. In our example, we are using windows so I have copied this file into the C:\Users\user\AppData\Roaming\Kodi\userdata\keymaps folder.

Now we need a text editor to actually edit the files. Any text editor will work but we recommend something that can open multiple files at once such as Sublime Text or Notepad++

== Testing your enviroment ==

Lets launch Kodi and try out our new skinners keymap features.

The following keys will then activate the corresponding action:

F5 - Reload skin (''used to see any changes instantly without restarting XBMC'')
F7 - Activated the KaiDialogToast.xml (''used to display the notification dialog'')
F8 - Show/Hide the Debug Info (''used to display the currently active windows or dialogs'')

As you can see all these features are incredibly important to a skinner.

[[File:Skinners_keymap_kodi.jpg]]

== Structure of Estuary ==
The default skin is very nicely laid out in actually quite a simple way. In our case on Windows, you can access the skin files in this folder C:\Program Files (x86)\Kodi\addons\skin.estuary\xml

Below are some explanations of the files you will see in the Estuary XML folder:

The file "Home.xml" is the basic home screen you see on first load of Kodi.

Files that start with "My" are the main sub windows from the main screen such as Music or TVShows.

Files that start with "Includes_" are all files that incorporate common elements that can be used all over the skin.

Files that start with "Dialogue_" are all popups you see in the use of Kodi

Files that start with "View_" are all the specific views you see in the skin, such as wide list or the Poster view for example.

Files that start with "Settings" are simply to detail the settings menu.

As you can probably tell, editing a skin is actually pretty logical and great effort has been made by the original developers to make it easy to understand.

== Making your first skin edit ==

As an example here, I am going to show you how to add a feature that was important to me but missing in the standard Estuary release.

This example will show you how to add a music rating to the wide list view.

[[File:Estuary mod music1.jpg]]

Currently the rating only shows under the album artwork when you have a single track focused on the right.

I will change this so that every rating shows next to each track name even when not focused.

First thing we need to do is find out what files to edit. Now this is pretty easy because we can press F8 on the keyboard to see the debug screen in Kodi.

Now browse to the screen you want to edit in Kodi and the debug text will change. In this case its changed to "MyMusicNav.xml" and Focus is "55 (Fixed list)".

[[File:Estuary_mod_music2.jpg]]

So go ahead and open these 2 files: "MyMusicNav.xml" and "View_55_WideList.xml". Its also important that we open the "includes.xml" file as this has many common elements that will help us.

At this point you may find it useful to start test deleting bits of the "View_55_WideList.xml". Try deleting different containers and control elements in the XML file.

You should quickly learn what bits do what with this method. For example if I remove the <itemlayout height="80" condition="Container.Content(songs)"> code section, all the track listings disappear!

Now we know what bits do what, we can start to edit. Lets look at this code:

[[File:Estuary mod music3.jpg]]

As you can see, its quite simple. This code shows the duration of the track on the widelist music screen. You can see where the control is positioned, how its aligned and what colour it is. In this case its grey.

As a quick test lets change the colour to yellow! Just change "<textcolor>grey</textcolor>" to "<textcolor>yellow</textcolor>". Go back to Kodi and hit F5 on the keyboard and all your track lengths go yellow!

[[File:Estuary_mod_music4.jpg]]

Magic! Now lets try adding some text instead of the duration, just as a test. Just change "<label>$INFO[ListItem.Label2]</label>" to "<label>Blah!</label>"

[[File:Estuary_mod_music6.jpg]]

OK so that was fun, but its probably best to change that back now. Undo(ctrl + z) and redo(ctrl + y) are your friends while testing :)

So lets actually get on with our modification, what we need to do is find out what label the user rating is. To find this out we need to look in the "includes.xml" file as the rating star resides in there as its a re-usable element all over the skin.

You can do a quick text search "Ctrl + s" and look for "rating". Easy huh!

[[File:Estuary_mod_music5.jpg]]

This looks quite complicated (and it is a little due to the settings in there) but actually it just shows a rating "circle" with either the user or the overall rating inside it.

What we are really looking for here is the infolabel string. We've circled it above as ListItem.UserRating so lets copy (Ctrl + c) that simple string for use later.

We don't need to do anything more with the includes file at this time but hopefully you can see the power of using re-usable elements in this file.

So now go back to your "View_55_WideList.xml" file and lets add a new control. All we are going to do is copy the duration control to just below.

[[File:Estuary_mod_music7.jpg]]

As you can see from the screenshot we now have a new control which has been modified with a few new values.

We've changed the position of the control to be slightly to the left of the song duration control.

We've also changed the colour to yellow and the label to our rating listitem. In this case its: "$INFO[ListItem.UserRating]"

[[File:Estuary_mod_music8.jpg]]

Right, that's it. We have managed to get the rating to show on each song track listing. Our objective has been achieved!

This example is obviously not complete, we need to change the control that is selected to also show the rating and possibly change the actual rating to star images but you get the idea!

Editing skins is easy, logical and quick once you get used to it. Good luck and let us know how you get on.

== Renaming and Reordering Main Menu Items ==

It is possible to do a few modifications on the main menu if you don't mind editing the Skin files.

The file you need to look at is ''\XML\home.xml'' around where the <control type="fixedlist" id="9000"> starts. If we scan down about to around line 879 you can see the start of the menu items. Estuary starts with movies but as you can see there are different controls for different menu items. The movies control has a label of <label>$LOCALIZE[342]</label> which means that it is translated from somewhere else. If you just wanted to rename movies to something like "My Movies" you could replace that line with <label>My Movies</label>. Of course if you do this, you are going to loose any other translations but you should get the idea.

It is also possible to re-order some menu items. In my case I want Live TV to show at the top as I use it most. All we need to do is move the entire <item></item> node up before the movie <item></item> node.

[[File:Re-order_and_move_Estuary.jpg‎]]

[[File:Re-order_and_move_Estuary_code.jpg‎]]

== Editing the Video OSD ==

One thing you might want to look at is modifying the Video OSD.

This requires looking at a number of files including:

'''OSD Background'''

The OSD background is pretty easy to change. You can find the image in the ''\media\dialogs'' folder of your skin. If you want to create a new one, I would advise making it the width of a 1080p display with some kind of transparency. Make sure you save it as a PNG to preserve the transparency and a dark colour so it can justify against the video background.

The actual XML file to edit here (and for most OSD changes) is the ''DialogueSeekBar.xml'' file. Jump to this control node to find the OSD background search for ''dialog-bg.png'' as below:

<texture>dialogs/dialog-bg.png</texture>

You can change the width here to something like 90% so that the OSD does not take up the whole screen or resposition it with the ''top'' XML tag.

'''Video and Audio Icons'''

We can continue to edit the ''DialogueSeekBar.xml'' file to find the audio and video flag icons. You may wish to reposition these or even create a new control node for them individually as currently they are all grouped together.

<param name="texture" value="$INFO[VideoPlayer.AudioChannels,flags/audiochannel/,.png]" />

You can again change the position of the icons or the size inside the control node.

'''Progress Bar'''

The progress bar is a little tricky as Estuary has a number of places where it can show, but we can start to edit it in the ''DialogueSeekBar.xml'' file again. Just do a search for:

<info>PVR.EpgEventProgress</info>

Changing the width and height is probably what you want but we can change the color or even the thickness too.

'''Top screen left'''

Finding out where the top bar strings are located was a lot more tricky but hopefully this article will save others the time in finding it.

The top left hand TV channel and program name are found in the ''variables.xml'' and search for the ''NowPlayingBreadcrumbsVar'' control node.

You can either comment this out or change it from here.

'''Top screen OSD right'''

The time and video duration is also quite difficult to find. The way I found it in the end (and this trick may help you for other searches) was to use notepad++ search by directory feature to look for the localisation string ''31080'' which is the english string ''Ends at'' which shows up in this location.

That search brought me to a file called ''Custom_1109_TopBarOverlay.xml''. Just search for the xml control node that contains ''<label>$INFO[System.Time]</label>''. I disabled this and introduced a new control node back in the ''DialogueSeekBar.xml'' file that will show on the actual OSD popup in future. But again it can be moved or resized as required

== Adding new views ==

'''Create the new view include'''

Lets start by copying an existing view, such as the music shift view. Copy the file 'View_500_Wall.xml' to a new file called 'View_503_WideWall.xml'. We are just choosing the next number along in the view list, you can check this by sorting all the XMLs by name and seeing the names of the views includes as seperate files.

'''Include the view in the Nav pages'''

We will need to set the Nav page to actually include the view now. In this example we are setting up a new WideWall view for music so we will need to look at the 'MyMusicNav.xml' file which is the master view for Music.

[[File:Mymusicnav views.png]]

As you can see, we have added in a new custom view number here of '503' which corresponds to the name of the include file we just created.

We also need to include the actual include name in 'MyMusicNav.xml' like so:

[[File:New view include.png]]

Lastly we need to actually include the new XML file in our main 'includes.xml' file like so:

[[File:Include wideWall.png]]

'''Update the view numbers'''

Because we have added a view, we now need to update all the references to the view number in the file. In this case we are changing '500' to '503'
The easiest way to do this is a quick search and replace in the new 'View_503_WideWall.xml' file. So lets change all references of ID '500' to '503'

'''Update the view label'''

Lastly we need to update the label of the view so we can see it. Find line 20 in the new 'View_503_WideWall.xml' file and change the translation Label (yes the 31102number is confusing buts its a translation label which in English means "Wall").

<viewtype label="31102">icon</viewtype>

to

<viewtype label="WideWall">icon</viewtype>

Thats it! Congrats, you should now have a new view in Estuary for your WideWall. You can from here start changing where this view is used or parts of the actual view to you liking.

In this example we have simply changed the Thumbnail to a Landscape graphic, a very simple change but with a nice dramatic effect. We also removed the label under the thumb to make it look streamlined.

[[File:WideWall Example small.jpg]]

== More advanced edits ==

Just to complete this guide, lets try and add some graphical stars to the widelist view, while also adding the focused stars.

Lets change the code we added earlier to an image control

[[File:Estuary_rating_image_control.jpg]]

Notice we are now adding an image control, with a texture that is calling a specific filename. In this case it is a star rating of 1-10 with half stars to make it shorter.

And we end up with something like this!

[[File:Estuary_rating_mod4.jpg]]

Last but not least, we need to add a new control for when the song is in focus by the user. This will ensure that the stars do not disappear when the user moves over each song with the selection bar.

[[File:Estuary_rating_image_control.jpg]]

So all we have done is copy the same code again and put it this time in the control, that is visible when "HasFocus" is selected.

All done!

== See also ==
'''Development:'''
* [[Add-on development]]
* [[Skinning]]

[[Category:Skin development]]

File:WideWall Example small.jpg

2018-07-21T13:59:56Z

Zag:

New view example

File:WideWall Example.jpg

2018-07-21T13:58:37Z

Zag:

Example of a new view in Estuary. WideWall.

File:Include wideWall.png

2018-07-21T13:55:07Z

Zag:

widewall

File:New view include.png

2018-07-21T13:45:31Z

Zag:

File:Mymusicnav views.png

2018-07-21T13:06:32Z

Zag:

HOW-TO:Screensaver addon

2018-07-16T22:34:24Z

Zag: Add another example screensaver Add-on

{{mininav|[[Development]]|[[Add-on development]]|[[Python development]]}}
<br />

=Introduction=
This tutorial will explain how to write your first Kodi/XBMC Screensaver Add-on<br />

[[File:Screensaver.video.jpg]]

=Tools=

Screensavers should be pretty easy in their most basic form. All you will need is a text editor or IDE and some artwork resources.

=Examples=
Since we don't have a full "HOW TO" guide for this yet (please feel free to sign up to the wiki and edit this page) we will just show some source code of other screensavers for now:

'''Python examples'''

https://github.com/zag2me/script.screensaver.example

https://github.com/XBMC-Addons/screensaver.picture.slideshow

https://github.com/vdb86/screensaver.digitalclock

'''C++ example'''

https://github.com/notspiff/screensaver.stars

You can either download as a zip and install both of these inside the kodi GUI from the install from zip feature. Or extract the zip into your userdata/add-ons folder.

=Extra info=

Check out the forum section for Screensavers and Visualisations

http://forum.kodi.tv/forumdisplay.php?fid=38

[[Category:Add-on development]]

HOW-TO:Estuary Modification

2018-03-20T20:01:34Z

Zag: instructions for changing the main menu

==Introduction==
Estuary is Kodi's default skin, so it makes a good example of how to get start with editing a skin

[[File:Estuary-logo.png]]

== Setting up a developer environment for skinning ==
First thing we need to do is setup a simple skin development environment:

To get the most out of it you'll need to either make a new keymap.xml or add this to your existing one.

<keymap>
<global>
<keyboard>
<F5>XBMC.ReloadSkin()</F5>
<F7>Notification(Testing 123,Hello world)</F7>
<F8>Skin.ToggleDebug()</F8>
</keyboard>
</global>
</keymap>

[[File:Keymap_xml.jpg]]

You will need to copy this keymap.xml file into the Kodi userdata folder. In our example, we are using windows so I have copied this file into the C:\Users\user\AppData\Roaming\Kodi\userdata\keymaps folder.

Now we need a text editor to actually edit the files. Any text editor will work but we recommend something that can open multiple files at once such as Sublime Text or Notepad++

== Testing your enviroment ==

Lets launch Kodi and try out our new skinners keymap features.

The following keys will then activate the corresponding action:

F5 - Reload skin (''used to see any changes instantly without restarting XBMC'')
F7 - Activated the KaiDialogToast.xml (''used to display the notification dialog'')
F8 - Show/Hide the Debug Info (''used to display the currently active windows or dialogs'')

As you can see all these features are incredibly important to a skinner.

[[File:Skinners_keymap_kodi.jpg]]

== Structure of Estuary ==
The default skin is very nicely laid out in actually quite a simple way. In our case on Windows, you can access the skin files in this folder C:\Program Files (x86)\Kodi\addons\skin.estuary\xml

Below are some explanations of the files you will see in the Estuary XML folder:

The file "Home.xml" is the basic home screen you see on first load of Kodi.

Files that start with "My" are the main sub windows from the main screen such as Music or TVShows.

Files that start with "Includes_" are all files that incorporate common elements that can be used all over the skin.

Files that start with "Dialogue_" are all popups you see in the use of Kodi

Files that start with "View_" are all the specific views you see in the skin, such as wide list or the Poster view for example.

Files that start with "Settings" are simply to detail the settings menu.

As you can probably tell, editing a skin is actually pretty logical and great effort has been made by the original developers to make it easy to understand.

== Making your first skin edit ==

As an example here, I am going to show you how to add a feature that was important to me but missing in the standard Estuary release.

This example will show you how to add a music rating to the wide list view.

[[File:Estuary mod music1.jpg]]

Currently the rating only shows under the album artwork when you have a single track focused on the right.

I will change this so that every rating shows next to each track name even when not focused.

First thing we need to do is find out what files to edit. Now this is pretty easy because we can press F8 on the keyboard to see the debug screen in Kodi.

Now browse to the screen you want to edit in Kodi and the debug text will change. In this case its changed to "MyMusicNav.xml" and Focus is "55 (Fixed list)".

[[File:Estuary_mod_music2.jpg]]

So go ahead and open these 2 files: "MyMusicNav.xml" and "View_55_WideList.xml". Its also important that we open the "includes.xml" file as this has many common elements that will help us.

At this point you may find it useful to start test deleting bits of the "View_55_WideList.xml". Try deleting different containers and control elements in the XML file.

You should quickly learn what bits do what with this method. For example if I remove the <itemlayout height="80" condition="Container.Content(songs)"> code section, all the track listings disappear!

Now we know what bits do what, we can start to edit. Lets look at this code:

[[File:Estuary mod music3.jpg]]

As you can see, its quite simple. This code shows the duration of the track on the widelist music screen. You can see where the control is positioned, how its aligned and what colour it is. In this case its grey.

As a quick test lets change the colour to yellow! Just change "<textcolor>grey</textcolor>" to "<textcolor>yellow</textcolor>". Go back to Kodi and hit F5 on the keyboard and all your track lengths go yellow!

[[File:Estuary_mod_music4.jpg]]

Magic! Now lets try adding some text instead of the duration, just as a test. Just change "<label>$INFO[ListItem.Label2]</label>" to "<label>Blah!</label>"

[[File:Estuary_mod_music6.jpg]]

OK so that was fun, but its probably best to change that back now. Undo(ctrl + z) and redo(ctrl + y) are your friends while testing :)

So lets actually get on with our modification, what we need to do is find out what label the user rating is. To find this out we need to look in the "includes.xml" file as the rating star resides in there as its a re-usable element all over the skin.

You can do a quick text search "Ctrl + s" and look for "rating". Easy huh!

[[File:Estuary_mod_music5.jpg]]

This looks quite complicated (and it is a little due to the settings in there) but actually it just shows a rating "circle" with either the user or the overall rating inside it.

What we are really looking for here is the infolabel string. We've circled it above as ListItem.UserRating so lets copy (Ctrl + c) that simple string for use later.

We don't need to do anything more with the includes file at this time but hopefully you can see the power of using re-usable elements in this file.

So now go back to your "View_55_WideList.xml" file and lets add a new control. All we are going to do is copy the duration control to just below.

[[File:Estuary_mod_music7.jpg]]

As you can see from the screenshot we now have a new control which has been modified with a few new values.

We've changed the position of the control to be slightly to the left of the song duration control.

We've also changed the colour to yellow and the label to our rating listitem. In this case its: "$INFO[ListItem.UserRating]"

[[File:Estuary_mod_music8.jpg]]

Right, that's it. We have managed to get the rating to show on each song track listing. Our objective has been achieved!

This example is obviously not complete, we need to change the control that is selected to also show the rating and possibly change the actual rating to star images but you get the idea!

Editing skins is easy, logical and quick once you get used to it. Good luck and let us know how you get on.

== Renaming and Reordering Main Menu Items ==

It is possible to do a few modifications on the main menu if you don't mind editing the Skin files.

The file you need to look at is ''\XML\home.xml'' around where the <control type="fixedlist" id="9000"> starts. If we scan down about to around line 879 you can see the start of the menu items. Estuary starts with movies but as you can see there are different controls for different menu items. The movies control has a label of <label>$LOCALIZE[342]</label> which means that it is translated from somewhere else. If you just wanted to rename movies to something like "My Movies" you could replace that line with <label>My Movies</label>. Of course if you do this, you are going to loose any other translations but you should get the idea.

It is also possible to re-order some menu items. In my case I want Live TV to show at the top as I use it most. All we need to do is move the entire <item></item> node up before the movie <item></item> node.

[[File:Re-order_and_move_Estuary.jpg‎]]

[[File:Re-order_and_move_Estuary_code.jpg‎]]

== Editing the Video OSD ==

One thing you might want to look at is modifying the Video OSD.

This requires looking at a number of files including:

'''OSD Background'''

The OSD background is pretty easy to change. You can find the image in the ''\media\dialogs'' folder of your skin. If you want to create a new one, I would advise making it the width of a 1080p display with some kind of transparency. Make sure you save it as a PNG to preserve the transparency and a dark colour so it can justify against the video background.

The actual XML file to edit here (and for most OSD changes) is the ''DialogueSeekBar.xml'' file. Jump to this control node to find the OSD background search for ''dialog-bg.png'' as below:

<texture>dialogs/dialog-bg.png</texture>

You can change the width here to something like 90% so that the OSD does not take up the whole screen or resposition it with the ''top'' XML tag.

'''Video and Audio Icons'''

We can continue to edit the ''DialogueSeekBar.xml'' file to find the audio and video flag icons. You may wish to reposition these or even create a new control node for them individually as currently they are all grouped together.

<param name="texture" value="$INFO[VideoPlayer.AudioChannels,flags/audiochannel/,.png]" />

You can again change the position of the icons or the size inside the control node.

'''Progress Bar'''

The progress bar is a little tricky as Estuary has a number of places where it can show, but we can start to edit it in the ''DialogueSeekBar.xml'' file again. Just do a search for:

<info>PVR.EpgEventProgress</info>

Changing the width and height is probably what you want but we can change the color or even the thickness too.

'''Top screen left'''

Finding out where the top bar strings are located was a lot more tricky but hopefully this article will save others the time in finding it.

The top left hand TV channel and program name are found in the ''variables.xml'' and search for the ''NowPlayingBreadcrumbsVar'' control node.

You can either comment this out or change it from here.

'''Top screen OSD right'''

The time and video duration is also quite difficult to find. The way I found it in the end (and this trick may help you for other searches) was to use notepad++ search by directory feature to look for the localisation string ''31080'' which is the english string ''Ends at'' which shows up in this location.

That search brought me to a file called ''Custom_1109_TopBarOverlay.xml''. Just search for the xml control node that contains ''<label>$INFO[System.Time]</label>''. I disabled this and introduced a new control node back in the ''DialogueSeekBar.xml'' file that will show on the actual OSD popup in future. But again it can be moved or resized as required

== More advanced edits ==

Just to complete this guide, lets try and add some graphical stars to the widelist view, while also adding the focused stars.

Lets change the code we added earlier to an image control

[[File:Estuary_rating_image_control.jpg]]

Notice we are now adding an image control, with a texture that is calling a specific filename. In this case it is a star rating of 1-10 with half stars to make it shorter.

And we end up with something like this!

[[File:Estuary_rating_mod4.jpg]]

Last but not least, we need to add a new control for when the song is in focus by the user. This will ensure that the stars do not disappear when the user moves over each song with the selection bar.

[[File:Estuary_rating_image_control.jpg]]

So all we have done is copy the same code again and put it this time in the control, that is visible when "HasFocus" is selected.

All done!

== See also ==
'''Development:'''
* [[Add-on development]]
* [[Skinning]]

[[Category:Skin development]]

File:Re-order and move Estuary code.jpg

2018-03-20T20:00:28Z

Zag:

File:Re-order and move Estuary.jpg

2018-03-20T19:57:13Z

Zag:

Samples

2018-02-27T15:54:12Z

Zag: /* Fake Sports TV Show library */ fix broken link

{{mininav| [[Troubleshooting]] {{l2|[[Development builds]] }} }}

{{forum link2|1=Questions? Comments? See the ''[http://forum.kodi.tv/showthread.php?tid=248794 discussion thread]''}}

''(Thanks to hdmkv for putting together these links)''

Kodi users are a demanding bunch when it comes to media players with Kodi & having as-close-to-perfect video playback capabilities as possible. All videos should play smoothly and w/o distracting artifacts such as stutters, frame skips, improper framerates, macroblocking, and audio drop-outs.

Below is a collection of a/v clips for testing, pushing media player capabilities. Not all types, but the most widely used or critical types for home theater enthusiasts. [[w:Fair use|Fair use]] is claimed on all non-[[w:copyleft|copyleft]] clips, as their the purpose is only for testing, technical evaluation, and documentation.

==3D Test Clips==

#[https://drive.google.com/file/d/0BwxFVkl63-lEd2c0ekxfbFd3Tmc/view?usp=sharing MVC 3D ISO Sample #1] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lEM2xjQndxV3ZzaVE/view?usp=sharing MVC 3D ISO Sample #2 with 3D Subtitles] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lEMkJTV21JNnhfNlE/view?usp=sharing MVC 3D ISO Sample #3 for Pop-out & Depth Evaluation] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lEWmRyc0YwUExxX0U/view?usp=sharing MVC 3D ISO Sample #4 for Proper Lip-synch & Clean Graphics Render Verification] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lETWMzM1dRZF9XMDA/view?usp=sharing MVC 3D MKV] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lEX3RpYTNEMFZxcjA/view?usp=sharing HSBS (side-by-side)] (MKV @ 1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lET0czejJBVXJLSkE/view?usp=sharing HTAB/HOU (top-and-bottom)] (MKV @ 1080p/23.976)

==HD Audio Test Clips==
{{note|To download, hover over link:
* If demo-world, click to go to site, then right-click thumbnail of video there & choose 'Save link as...' to download
* For rest, just click}}

#[https://mega.nz/#!cM9VmBSL!mME5qULH2H5M24vLmjqfZZkaoUjY6RsrGPiw3ultMW0 Dolby Digital Plus 5.1] (M2TS @ 1080p/29.970) ''(thanks wesk05)''
#[http://www.demo-world.eu/download-2d-trailers/?file=dolby_digital_plus_channel_check_lossless-DWEU.mkv&pic=dolby_digital_plus_channel_check_lossless.jpg Dolby Digital Plus 7.1 Channel Check] (MKV @ 1080p/29.970)
#Dolby TrueHD 5.1 (use clip #10 in 'Codecs' section below)
#[http://www.demo-world.eu/download-2d-trailers/?file=dolby_truehd_channel_check_lossless-DWEU.mkv&pic=dolby_truehd_channel_check_lossless.jpg Dolby TrueHD 7.1 Channel Check] (MKV @ 1080p/29.970)
#[http://www.demo-world.eu/download-2d-trailers/?file=dolby_amaze_lossless-DWEU.m2ts&pic=dolby_amaze.jpg Dolby ATMOS 'Amaze' Demo] (M2TS @ 1080p/24.000)
#[https://drive.google.com/open?id=0BwxFVkl63-lENElIcC1xTnF2Yk0 Dolby ATMOS 'Helicopter' Demo] (M2TS @ 1080p/29.970 with DD+ 5.1 secondary track)
#[https://www.demolandia.net/downloads.php?id=236762 Dolby ATMOS 'Audiosphere' Demo] (M2TS @ 1080p/24.000)
#[https://www.demolandia.net/downloads.php?id=52783232 Dolby ATMOS 'Silent' Demo] (M2TS @ 1080p/24.000)
#[https://drive.google.com/file/d/0BwxFVkl63-lEcU1ScWZuMjhpOXM/view?usp=sharing DTS-HD HRA 5.1] (MKV @ 1080p/23.976 VC-1)
#[http://www.demo-world.eu/download-2d-trailers/?file=dts_orchestra_short_lossless-DWEU.mkv&pic=dts_orchestra.jpg DTS-HD HRA 7.1] (MKV @ 1080p/29.970)
#[https://drive.google.com/file/d/0B4nYAKUiVpepY1NuQW5ER3l3SXc/edit?usp=sharing DTS-HD MA 5.1 Channel Check] (M2TS @ 1080p/23.976)
#[https://drive.google.com/file/d/0B67BGVX7nHIlNlJBenpkQkhFXzA/view DTS-HD MA 5.1 24-bit 192kHz audio-only sample] (MKV) ''(thanks HomerJau)''
#[http://www.demo-world.eu/download-2d-trailers/?file=dts_hd_master_audio_sound_check_7_1_lossless-DWEU.mkv&pic=dts_hd_master_audio_sound_check_7_1_lossless.jpg DTS-HD MA 7.1 Speaker Phase] (MKV @ 1080p/23.976)
#[https://drive.google.com/open?id=0Bx63o79bMC7lMEMxUmxzV2NtYTA DTS-HD MA 7.1 'Dredd' Audio Channel Check] (M2TS @ 1080p/23.976) ''(thanks looun)''
#[http://www.demo-world.eu/download-2d-trailers/?file=dts_x_all_around_us_lossless-DWEU.mkv&pic=dts_x_all_around_us.jpg DTS:X 'All Around Us' Demo] (MKV @ 1080p/23.976) ''(thanks wesk05)''
#[https://drive.google.com/open?id=0BwxFVkl63-lEQWNKRnBPUlB3QXc DTS:X 'Gravity' Demo] (MKV @ 1080p/23.976) ''(thanks wesk05; modified to only retain the X track)''
#[https://www.demolandia.net/downloads.php?id=87980801 DTS:X 'Sound Unbound Callout 11.1' Demo] (M2TS @ 1080p/24.000)
#[https://www.demolandia.net/downloads.php?id=69530805 DTS:X 'Listen X Long' Demo] (M2TS @ 1080p/24.000)
#[https://mega.nz/#!0NVhDIbY!D4Fte7Kb7728H9CRY3IVTHJ45ZwkCQiugdFS7pZCN_s DTS:X 'Movement' Demo] (M2TS @ 1080p/23.976) ''(thanks wesk05)''
#[https://mega.nz/#!Rcl1ECiL!pzPT5LvMyYIoKbsm3HdMDi2vO6aPpE8gAjLsSTH1DZg LPCM 5.1] (MKV @ 1080p/23.976) ''(thanks wesk05)''
#[https://drive.google.com/file/d/0BwxFVkl63-lEV2JjazFWQ05OSG8/view?usp=sharing LPCM 7.1] (MKV @ 1080p/23.976)
#[https://www2.iis.fraunhofer.de/AAC/multichannel.html AAC 5.1]
#FLAC 5.1 (use clip #6 in '3D Test Clips' section above)
#[https://drive.google.com/file/d/0B67BGVX7nHIlNlJBenpkQkhFXzA/view FLAC 5.1 24-bit 192kHz audio-only sample] ''(thanks HomerJau)''
#[http://www.2l.no/hires/index.html FLAC many formats]
#[https://www.cybele.de/geraete-software-download FLAC many formats] (bottom of page)

==Codecs, Framerates and Subtitles==

#[https://drive.google.com/file/d/0BwxFVkl63-lERkJRU003ZTd2VEk/view?usp=sharing H.264 1080p/23.976] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lEdzlZZ2lCLTVLa2c/view?usp=sharing H.264 1080p/24.000] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lEbFBzak1sbmU1N0E/view?usp=sharing H.264 1080i/25.000] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lEWDUzUVUtZEw4cDA/view?usp=sharing H.264 1080p/25.000] (MKV)
#[https://mega.nz/#!XI1yiKLA!rF4vweNo_xA7vpSzpLU-JctqfUGZN4vVU1m6WIJ5lT4 H.264 1080i/29.970 4:2:0@High 26Mbps] (C-Band satellite capture in MKV w/DTS-HD MA 2.0 audio, converted from E-AC3) ''(thanks alanisrox69)''
#[http://opencubetech.com/page47/ H.264 1080i/50.000] (download and change .mxf extension to .ts)
#[https://drive.google.com/file/d/0BwxFVkl63-lEbVptTVZ2NENURHM/view?usp=sharing H.264 1080p/50.000] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lEUGZnR1JHUUU0WEk/view?usp=sharing H.264 1080p/59.940] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lETTVtaVV0LUVRZ1k/view?usp=sharing H.264 1080p/60.000] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lETFVpOWRVVGNfeEU/view?usp=sharing VC-1 1080p/23.976] (MKV w/TrueHD 5.1 audio)
#[https://drive.google.com/file/d/0BwxFVkl63-lERnhlY1pHeW5wbjQ/view?usp=sharing VC-1 1080i/29.970] (MKV w/DTS-HD MA 5.1 audio)
#[https://drive.google.com/file/d/0BwxFVkl63-lETXlOa3hEMmVyZGM/view?usp=sharing MPEG2 1080i/29.970] (U.S. ATSC OTA capture, muxed into MKV w/DD5.1 audio)
#[https://mega.nz/#!GJMAADTK!deabwHlqtw2I_ihoY6_0xnxT_1W_d3jpAjnANKRBAzE MPEG2 4:2:0@High 1080i/29.970 36Mbps] (C-Band satellite capture in TS w/DTS-HD MA 5.1 audio, converted from E-AC3) ''(thanks alanisrox69 for #13-15)''
#[https://mega.nz/#!jREAxYgb!MtjBIh1oSJJBZgLT7AcdG88hGCFG-ak7pC2AyjrsaIQ MPEG2 4:2:0@High 720p/59.940 20Mbps] (C-Band satellite capture in TS)
#[https://mega.nz/#!c9dhAaKA!MG5Yi-MJNATE2_KqcnNJZCRKtTWvdjJP1NwG8Ggdw3E MPEG2 4:2:2@High 1080i/29.970 35Mbps] (C-Band satellite capture in TS w/DTS-HD MA 5.1 audio, converted from E-AC3) (most media players can't play this; Sigma SoC-based media players and Intel i3+ NUC's/HTPC's can)
#[https://www.dropbox.com/sh/6iy4gxgsfn14opq/AAAK_L1M_NwZwBPb5IkEPh7Ga?dl=0 Hi10 Anime Samples] ''(thanks Morien)''
#H.265 1080p (medium bitrate) Test #1 [https://drive.google.com/file/d/0B3-obtCH8dE8d04yQnY5ZkFJdVE/view?usp=sharing in ISO], and [https://drive.google.com/file/d/0B3-obtCH8dE8V0NXdi1Jd3NrNkk/view?usp=sharing in MKV] ''(thanks Mike for #16-17)''
#H.265 1080p (medium bitrate) Test #2 [https://drive.google.com/file/d/0B3-obtCH8dE8UnZiV2kyRGZEWW8/view?usp=sharing in ISO], and [https://drive.google.com/file/d/0B3-obtCH8dE8bFdvWVFUMlNjX0E/view?usp=sharing in MKV]
#[https://drive.google.com/file/d/0BwxFVkl63-lEbWhqS284RkpNMXc/view?usp=sharing 2D Forced Subtitles Sample #1 (SRT)]
#[https://drive.google.com/file/d/0BwxFVkl63-lEVEluSFZ4NlhpLUk/view?usp=sharing 2D Forced Subtitles Sample #2 (PGS)]
#3D Subtitles (use clip #2 in '3D Test Clips' section above)

==4K (UltraHD)==
{{note|To download, hover over link:
* If demo-world, click to go to site, then right-click thumbnail of video there & choose 'Save link as...' to download
* For any YouTube video, [https://www.4kdownload.com/products/product-videodownloader use this free tool] to download in original quality}}

#[https://drive.google.com/open?id=0BwxFVkl63-lEY3l3ODJReDg3RzQ H.264 29.970fps, 51Mbps] (in MOV, hdmkv's iPhone 6S raw 4K footage)
#[https://www.youtube.com/watch?v=Ppz41EmaJyU H.264 30.000fps] (in MP4, 4K Test Patterns) (YouTube) ''(thanks hansolo)''
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=111 H.264 50.000fps] (in MP4, Astra DVB satellite capture sample)
#[http://www.demo-world.eu/download-2d-trailers-uhd/?file=samsung_seven_wonders_of_the_world_china_uhd-DWEU.mkv&pic=samsung_seven_wonders_of_the_world_china.jpg H.264 59.940fps] (in MKV)
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=101 HEVC 8-bit 29.970fps] (in MP4)
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=45 HEVC 10-bit 23.976fps] (in TS)
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=96 HEVC 10-bit 59.940fps] (in TS)
#[https://drive.google.com/open?id=0BwxFVkl63-lEdVBuZkltckdZZ0k HEVC 10-bit 59.940fps] (Korean ATSC 3.0 satellite TV capture sample)
#[http://hdrsamples.com/ HDR 10-bit HEVC 24.000fps] (in MP4, 'Exodus' and 'Life of Pi' samples)
#[https://drive.google.com/open?id=0BwxFVkl63-lEdU9Ma0VYc3YxSVE HDR 10-bit HEVC 25.000fps] (in TS, Astra DVB satellite capture sample; no audio) ''(courtesy WeTek)''
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=144 HDR 10-bit HEVC 59.940fps] (in MP4, Camp by Sony)
#[https://drive.google.com/open?id=0BwxFVkl63-lEc3k0aldZaGtaVm8 DolbyVision 10-bit HEVC 23.976fps] (in TS, LG Comparison Demo) ''(thanks soyhakan)''
#[https://drive.google.com/open?id=0BwxFVkl63-lEWmNWcGl4eVRWS2M DolbyVision 10-bit HEVC 23.976fps] (in TS, LG Trailer) ''(thanks soyhakan)''
#[https://www.youtube.com/watch?v=s6zR2T9vn2c VP9] (open-source alternative to HEVC) (YouTube)
#[https://mega.nz/#!hJdFEIBI!uSOjZtkkjIVYSfqD9aSfONf1yq__uQvlsf47pCtFvdQ VP9 Profile 2 HDR #1] The World in HDR (in MKV, downloaded from YouTube) ''(thanks wesk05)''
#[https://mega.nz/#!pQEGgRwY!pD9whIlM-U9tJIA-LojxSt582BAZGfdSA5wAQLT06I4 VP9 Profile 2 HDR #2] The Redwoods (in MKV, downloaded from YouTube) ''(thanks wesk05)''
#[https://www.youtube.com/watch?v=nRt4Duf7GoI 5K (5120x2700) 60.000fps] (in MP4) (YouTube)
#[https://www.demolandia.net/downloads.php?id=60876578 HEVC 10-bit 23.976fps] (in MKV)
#[https://www.youtube.com/watch?v=ChOhcHD8fBA 8K (7680x4320) 29.970fps] (in MP4) (YouTube)
#[https://www.demolandia.net/downloads.php?id=73498539 HEVC 10-bit 23.976fps] (in MKV)
#[https://www.demolandia.net/downloads.php?id=99364567 HEVC 10-bit 23.976fps] (in MKV)

==Bitrate Test Clips==
Media players should be able play 70Mbps or better smoothly, w/o stutters for full 1080p, and 108-128Mbps for full 4K

*[http://jell.yfish.us/ Jellyfish, up to 400Mbps] (in H.264 and H.265 HEVC MKV) ''(thanks ScottAllyn01 for your useful site)''
*[http://dl.ganjanetwork.ru/Files/Video%20Test%20Files/Bitrate/Birds/ Birds, up to 90Mbps] (in H.264 MKV or M2TS)

==Resources for Additional Test Clips or Samples==

*[http://bbb3d.renderfarming.net/download.html Big Buck Bunny] (test suite with 2D, 3D and 4K clips)
*[http://www.cnx-software.com/2010/03/17/where-to-get-video-audio-and-image-samples/ CNXSoft's samples/links]
*[http://www.w6rz.net/ W6RZ MPEG2 clips]
*[http://thedigitaltheater.com/index.php/dolby-trailers/ The Digital Theater] (several Dolby ATMOS clips)
*[http://www.demo-world.eu/2d-demo-trailers-hd/ Demo World trailers] (several directly linked to above)
*[https://www.koi-sama.net/files/hi10/ AVC High 10 Profile Anime Samples] ''(thanks Morien)''
*[http://4ksamples.com/ 4Ksamples.com] (movie, sport, nature clips in 4K)
*[https://www.youtube.com/watch?v=k_okcNVZqqI&list=PLD33E5618740295DF Jacob + Katie Schwarz: We See the World in 4K] (beautiful 4K nature videos) (YouTube)
*[https://www.youtube.com/user/aroundtheworld4k Around the World 4K] (Cities worldwide in striking 4K) (YouTube)
*[https://www.youtube.com/channel/UCW35MLO96M_UVG7YzMt1I2A/videos Cities in 4K] (Similar to above) (YouTube)
*[https://www.youtube.com/channel/UC_3n6GTFuC4tTAojueLBTHg/playlists Manufacturer and other demos in 4K] (YouTube)
*[http://www.imaging-resource.com/news/2014/11/19/samsung-nx1-4k-video-samples-and-new-full-res-frame-grabs-available-for-do Imaging Resource 4K Samples] ''(thanks Karnis)''
*[https://www.youtube.com/channel/UCve7_yAZHFNipzeAGBI5t9g/videos The HDR Channel] (YouTube)
*[http://demo-uhd3d.com/ Demo UHD 3D] (various H.265 & H.265 4K clips) ''(thanks wrxtasy)''
*[https://x265.com/hevc-video-files/ x265 HEVC Samples]
*[http://www.evosiastudios.com/category/portfolio/films/ Evosia Studios] (several beautiful 1080p to 4K films)
*[http://www.libde265.org/downloads-videos/ libde265] (1080p to maxed-out 4K samples) ''(thanks Martijn)''
*[http://timestormfilms.net/ Timestorm Films] (4K to 8K videos)
*[http://samples.mplayerhq.hu/ MplayerHQ's library] (many clips)
::{{note|<code>http://samples.mplayerhq.hu</code> can even be added to Kodi as a video source, for easy loading, if you have a fast enough connection.}}

== Library samples ==

=== Ned's fake movie library ===
:A zipped collection of 1,000 empty movie files, with NFO files, poster, and fanart for each entry. Various movies from different years, including sequels/sets, remakes, movies named the same but unrelated, various genres, and so on. Useful for testing things like library scanning speed, library navigation, filtering, etc.

:* https://www.dropbox.com/s/llciqryeqqk4t70/Test%20video%20library.zip?dl=0

=== Music library ===
: Just the one album for now but hope to increase this over time. It's a complete album in MP3 format, tagged with Musicbrainz Picard ID3v2.3 (ID3v1 ID3v2.3) with extra genre, comment and composer tags for testing. Coverart is also included as a folder.jpg file. The album is licensed "Attribution-ShareAlike 3.0 Unported Creative Commons license" by the artist. You can download or pay for the album here if you like it. http://hungrylucy.com/album/pulse-of-the-earth

:* https://www.dropbox.com/s/rk8ue5fs49v5pnm/Creative_Commons_Music.zip?dl=0

=== Fake Sports TV Show library ===
: Here is a fake sports TV show library for use with the Kodi sports scraper. It includes a number of sports folders broken down into seasons and then events. This should work nicely with the current Sports TV scraper on the Kodi forums.

:* https://www.thesportsdb.com/Sports_fake_video_files.zip

=== Homebrew Game Roms ===
: This is a location to find a number of freely licensed "homebrew" console games that can be downloaded for testing with Kodi's upcoming retroplayer feature. They include NES, Gameboy and Snes titles.

:* https://github.com/OpenEmu/OpenEmu-Update/tree/master/Homebrew

== See also ==
* [[Video levels and color space]]

[[Category:Troubleshooting]]

HOW-TO:Estuary Modification

2018-01-02T14:41:24Z

Zag: Update for editing the OSD in Estuary

==Introduction==
Estuary is Kodi's default skin, so it makes a good example of how to get start with editing a skin

[[File:Estuary-logo.png]]

== Setting up a developer environment for skinning ==
First thing we need to do is setup a simple skin development environment:

To get the most out of it you'll need to either make a new keymap.xml or add this to your existing one.

<keymap>
<global>
<keyboard>
<F5>XBMC.ReloadSkin()</F5>
<F7>Notification(Testing 123,Hello world)</F7>
<F8>Skin.ToggleDebug()</F8>
</keyboard>
</global>
</keymap>

[[File:Keymap_xml.jpg]]

You will need to copy this keymap.xml file into the Kodi userdata folder. In our example, we are using windows so I have copied this file into the C:\Users\user\AppData\Roaming\Kodi\userdata\keymaps folder.

Now we need a text editor to actually edit the files. Any text editor will work but we recommend something that can open multiple files at once such as Sublime Text or Notepad++

== Testing your enviroment ==

Lets launch Kodi and try out our new skinners keymap features.

The following keys will then activate the corresponding action:

F5 - Reload skin (''used to see any changes instantly without restarting XBMC'')
F7 - Activated the KaiDialogToast.xml (''used to display the notification dialog'')
F8 - Show/Hide the Debug Info (''used to display the currently active windows or dialogs'')

As you can see all these features are incredibly important to a skinner.

[[File:Skinners_keymap_kodi.jpg]]

== Structure of Estuary ==
The default skin is very nicely laid out in actually quite a simple way. In our case on Windows, you can access the skin files in this folder C:\Program Files (x86)\Kodi\addons\skin.estuary\xml

Below are some explanations of the files you will see in the Estuary XML folder:

The file "Home.xml" is the basic home screen you see on first load of Kodi.

Files that start with "My" are the main sub windows from the main screen such as Music or TVShows.

Files that start with "Includes_" are all files that incorporate common elements that can be used all over the skin.

Files that start with "Dialogue_" are all popups you see in the use of Kodi

Files that start with "View_" are all the specific views you see in the skin, such as wide list or the Poster view for example.

Files that start with "Settings" are simply to detail the settings menu.

As you can probably tell, editing a skin is actually pretty logical and great effort has been made by the original developers to make it easy to understand.

== Making your first skin edit ==

As an example here, I am going to show you how to add a feature that was important to me but missing in the standard Estuary release.

This example will show you how to add a music rating to the wide list view.

[[File:Estuary mod music1.jpg]]

Currently the rating only shows under the album artwork when you have a single track focused on the right.

I will change this so that every rating shows next to each track name even when not focused.

First thing we need to do is find out what files to edit. Now this is pretty easy because we can press F8 on the keyboard to see the debug screen in Kodi.

Now browse to the screen you want to edit in Kodi and the debug text will change. In this case its changed to "MyMusicNav.xml" and Focus is "55 (Fixed list)".

[[File:Estuary_mod_music2.jpg]]

So go ahead and open these 2 files: "MyMusicNav.xml" and "View_55_WideList.xml". Its also important that we open the "includes.xml" file as this has many common elements that will help us.

At this point you may find it useful to start test deleting bits of the "View_55_WideList.xml". Try deleting different containers and control elements in the XML file.

You should quickly learn what bits do what with this method. For example if I remove the <itemlayout height="80" condition="Container.Content(songs)"> code section, all the track listings disappear!

Now we know what bits do what, we can start to edit. Lets look at this code:

[[File:Estuary mod music3.jpg]]

As you can see, its quite simple. This code shows the duration of the track on the widelist music screen. You can see where the control is positioned, how its aligned and what colour it is. In this case its grey.

As a quick test lets change the colour to yellow! Just change "<textcolor>grey</textcolor>" to "<textcolor>yellow</textcolor>". Go back to Kodi and hit F5 on the keyboard and all your track lengths go yellow!

[[File:Estuary_mod_music4.jpg]]

Magic! Now lets try adding some text instead of the duration, just as a test. Just change "<label>$INFO[ListItem.Label2]</label>" to "<label>Blah!</label>"

[[File:Estuary_mod_music6.jpg]]

OK so that was fun, but its probably best to change that back now. Undo(ctrl + z) and redo(ctrl + y) are your friends while testing :)

So lets actually get on with our modification, what we need to do is find out what label the user rating is. To find this out we need to look in the "includes.xml" file as the rating star resides in there as its a re-usable element all over the skin.

You can do a quick text search "Ctrl + s" and look for "rating". Easy huh!

[[File:Estuary_mod_music5.jpg]]

This looks quite complicated (and it is a little due to the settings in there) but actually it just shows a rating "circle" with either the user or the overall rating inside it.

What we are really looking for here is the infolabel string. We've circled it above as ListItem.UserRating so lets copy (Ctrl + c) that simple string for use later.

We don't need to do anything more with the includes file at this time but hopefully you can see the power of using re-usable elements in this file.

So now go back to your "View_55_WideList.xml" file and lets add a new control. All we are going to do is copy the duration control to just below.

[[File:Estuary_mod_music7.jpg]]

As you can see from the screenshot we now have a new control which has been modified with a few new values.

We've changed the position of the control to be slightly to the left of the song duration control.

We've also changed the colour to yellow and the label to our rating listitem. In this case its: "$INFO[ListItem.UserRating]"

[[File:Estuary_mod_music8.jpg]]

Right, that's it. We have managed to get the rating to show on each song track listing. Our objective has been achieved!

This example is obviously not complete, we need to change the control that is selected to also show the rating and possibly change the actual rating to star images but you get the idea!

Editing skins is easy, logical and quick once you get used to it. Good luck and let us know how you get on.

== Editing the Video OSD ==

One thing you might want to look at is modifying the Video OSD.

This requires looking at a number of files including:

'''OSD Background'''

The OSD background is pretty easy to change. You can find the image in the ''\media\dialogs'' folder of your skin. If you want to create a new one, I would advise making it the width of a 1080p display with some kind of transparency. Make sure you save it as a PNG to preserve the transparency and a dark colour so it can justify against the video background.

The actual XML file to edit here (and for most OSD changes) is the ''DialogueSeekBar.xml'' file. Jump to this control node to find the OSD background search for ''dialog-bg.png'' as below:

<texture>dialogs/dialog-bg.png</texture>

You can change the width here to something like 90% so that the OSD does not take up the whole screen or resposition it with the ''top'' XML tag.

'''Video and Audio Icons'''

We can continue to edit the ''DialogueSeekBar.xml'' file to find the audio and video flag icons. You may wish to reposition these or even create a new control node for them individually as currently they are all grouped together.

<param name="texture" value="$INFO[VideoPlayer.AudioChannels,flags/audiochannel/,.png]" />

You can again change the position of the icons or the size inside the control node.

'''Progress Bar'''

The progress bar is a little tricky as Estuary has a number of places where it can show, but we can start to edit it in the ''DialogueSeekBar.xml'' file again. Just do a search for:

<info>PVR.EpgEventProgress</info>

Changing the width and height is probably what you want but we can change the color or even the thickness too.

'''Top screen left'''

Finding out where the top bar strings are located was a lot more tricky but hopefully this article will save others the time in finding it.

The top left hand TV channel and program name are found in the ''variables.xml'' and search for the ''NowPlayingBreadcrumbsVar'' control node.

You can either comment this out or change it from here.

'''Top screen OSD right'''

The time and video duration is also quite difficult to find. The way I found it in the end (and this trick may help you for other searches) was to use notepad++ search by directory feature to look for the localisation string ''31080'' which is the english string ''Ends at'' which shows up in this location.

That search brought me to a file called ''Custom_1109_TopBarOverlay.xml''. Just search for the xml control node that contains ''<label>$INFO[System.Time]</label>''. I disabled this and introduced a new control node back in the ''DialogueSeekBar.xml'' file that will show on the actual OSD popup in future. But again it can be moved or resized as required

== More advanced edits ==

Just to complete this guide, lets try and add some graphical stars to the widelist view, while also adding the focused stars.

Lets change the code we added earlier to an image control

[[File:Estuary_rating_image_control.jpg]]

Notice we are now adding an image control, with a texture that is calling a specific filename. In this case it is a star rating of 1-10 with half stars to make it shorter.

And we end up with something like this!

[[File:Estuary_rating_mod4.jpg]]

Last but not least, we need to add a new control for when the song is in focus by the user. This will ensure that the stars do not disappear when the user moves over each song with the selection bar.

[[File:Estuary_rating_image_control.jpg]]

So all we have done is copy the same code again and put it this time in the control, that is visible when "HasFocus" is selected.

All done!

== See also ==
'''Development:'''
* [[Add-on development]]
* [[Skinning]]

[[Category:Skin development]]

Samples

2017-12-13T10:30:28Z

Zag: /* Music library */ fix CC music link

{{mininav| [[Troubleshooting]] {{l2|[[Development builds]] }} }}

{{forum link2|1=Questions? Comments? See the ''[http://forum.kodi.tv/showthread.php?tid=248794 discussion thread]''}}

''(Thanks to hdmkv for putting together these links)''

Kodi users are a demanding bunch when it comes to media players with Kodi & having as-close-to-perfect video playback capabilities as possible. All videos should play smoothly and w/o distracting artifacts such as stutters, frame skips, improper framerates, macroblocking, and audio drop-outs.

Below is a collection of a/v clips for testing, pushing media player capabilities. Not all types, but the most widely used or critical types for home theater enthusiasts. [[w:Fair use|Fair use]] is claimed on all non-[[w:copyleft|copyleft]] clips, as their the purpose is only for testing, technical evaluation, and documentation.

==3D Test Clips==

#[https://drive.google.com/file/d/0BwxFVkl63-lEd2c0ekxfbFd3Tmc/view?usp=sharing MVC 3D ISO Sample #1] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lEM2xjQndxV3ZzaVE/view?usp=sharing MVC 3D ISO Sample #2 with 3D Subtitles] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lEMkJTV21JNnhfNlE/view?usp=sharing MVC 3D ISO Sample #3 for Pop-out & Depth Evaluation] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lEWmRyc0YwUExxX0U/view?usp=sharing MVC 3D ISO Sample #4 for Proper Lip-synch & Clean Graphics Render Verification] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lETWMzM1dRZF9XMDA/view?usp=sharing MVC 3D MKV] (1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lEX3RpYTNEMFZxcjA/view?usp=sharing HSBS (side-by-side)] (MKV @ 1080p/23.976)
#[https://drive.google.com/file/d/0BwxFVkl63-lET0czejJBVXJLSkE/view?usp=sharing HTAB/HOU (top-and-bottom)] (MKV @ 1080p/23.976)

==HD Audio Test Clips==
{{note|To download, hover over link:
* If demo-world, click to go to site, then right-click thumbnail of video there & choose 'Save link as...' to download
* For rest, just click}}

#[https://mega.nz/#!cM9VmBSL!mME5qULH2H5M24vLmjqfZZkaoUjY6RsrGPiw3ultMW0 Dolby Digital Plus 5.1] (M2TS @ 1080p/29.970) ''(thanks wesk05)''
#[http://www.demo-world.eu/download-2d-trailers/?file=dolby_digital_plus_channel_check_lossless-DWEU.mkv&pic=dolby_digital_plus_channel_check_lossless.jpg Dolby Digital Plus 7.1 Channel Check] (MKV @ 1080p/29.970)
#Dolby TrueHD 5.1 (use clip #10 in 'Codecs' section below)
#[http://www.demo-world.eu/download-2d-trailers/?file=dolby_truehd_channel_check_lossless-DWEU.mkv&pic=dolby_truehd_channel_check_lossless.jpg Dolby TrueHD 7.1 Channel Check] (MKV @ 1080p/29.970)
#[http://www.demo-world.eu/download-2d-trailers/?file=dolby_amaze_lossless-DWEU.m2ts&pic=dolby_amaze.jpg Dolby ATMOS 'Amaze' Demo] (M2TS @ 1080p/24.000)
#[https://drive.google.com/open?id=0BwxFVkl63-lENElIcC1xTnF2Yk0 Dolby ATMOS 'Helicopter' Demo] (M2TS @ 1080p/29.970 with DD+ 5.1 secondary track)
#[https://www.demolandia.net/downloads.php?id=236762 Dolby ATMOS 'Audiosphere' Demo] (M2TS @ 1080p/24.000)
#[https://www.demolandia.net/downloads.php?id=52783232 Dolby ATMOS 'Silent' Demo] (M2TS @ 1080p/24.000)
#[https://drive.google.com/file/d/0BwxFVkl63-lEcU1ScWZuMjhpOXM/view?usp=sharing DTS-HD HRA 5.1] (MKV @ 1080p/23.976 VC-1)
#[http://www.demo-world.eu/download-2d-trailers/?file=dts_orchestra_short_lossless-DWEU.mkv&pic=dts_orchestra.jpg DTS-HD HRA 7.1] (MKV @ 1080p/29.970)
#[https://drive.google.com/file/d/0B4nYAKUiVpepY1NuQW5ER3l3SXc/edit?usp=sharing DTS-HD MA 5.1 Channel Check] (M2TS @ 1080p/23.976)
#[https://drive.google.com/file/d/0B67BGVX7nHIlNlJBenpkQkhFXzA/view DTS-HD MA 5.1 24-bit 192kHz audio-only sample] (MKV) ''(thanks HomerJau)''
#[http://www.demo-world.eu/download-2d-trailers/?file=dts_hd_master_audio_sound_check_7_1_lossless-DWEU.mkv&pic=dts_hd_master_audio_sound_check_7_1_lossless.jpg DTS-HD MA 7.1 Speaker Phase] (MKV @ 1080p/23.976)
#[https://drive.google.com/open?id=0Bx63o79bMC7lMEMxUmxzV2NtYTA DTS-HD MA 7.1 'Dredd' Audio Channel Check] (M2TS @ 1080p/23.976) ''(thanks looun)''
#[http://www.demo-world.eu/download-2d-trailers/?file=dts_x_all_around_us_lossless-DWEU.mkv&pic=dts_x_all_around_us.jpg DTS:X 'All Around Us' Demo] (MKV @ 1080p/23.976) ''(thanks wesk05)''
#[https://drive.google.com/open?id=0BwxFVkl63-lEQWNKRnBPUlB3QXc DTS:X 'Gravity' Demo] (MKV @ 1080p/23.976) ''(thanks wesk05; modified to only retain the X track)''
#[https://www.demolandia.net/downloads.php?id=87980801 DTS:X 'Sound Unbound Callout 11.1' Demo] (M2TS @ 1080p/24.000)
#[https://www.demolandia.net/downloads.php?id=69530805 DTS:X 'Listen X Long' Demo] (M2TS @ 1080p/24.000)
#[https://mega.nz/#!0NVhDIbY!D4Fte7Kb7728H9CRY3IVTHJ45ZwkCQiugdFS7pZCN_s DTS:X 'Movement' Demo] (M2TS @ 1080p/23.976) ''(thanks wesk05)''
#[https://mega.nz/#!Rcl1ECiL!pzPT5LvMyYIoKbsm3HdMDi2vO6aPpE8gAjLsSTH1DZg LPCM 5.1] (MKV @ 1080p/23.976) ''(thanks wesk05)''
#[https://drive.google.com/file/d/0BwxFVkl63-lEV2JjazFWQ05OSG8/view?usp=sharing LPCM 7.1] (MKV @ 1080p/23.976)
#[https://www2.iis.fraunhofer.de/AAC/multichannel.html AAC 5.1]
#FLAC 5.1 (use clip #6 in '3D Test Clips' section above)
#[https://drive.google.com/file/d/0B67BGVX7nHIlNlJBenpkQkhFXzA/view FLAC 5.1 24-bit 192kHz audio-only sample] ''(thanks HomerJau)''
#[http://www.2l.no/hires/index.html FLAC many formats]
#[https://www.cybele.de/geraete-software-download FLAC many formats] (bottom of page)

==Codecs, Framerates and Subtitles==

#[https://drive.google.com/file/d/0BwxFVkl63-lERkJRU003ZTd2VEk/view?usp=sharing H.264 1080p/23.976] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lEdzlZZ2lCLTVLa2c/view?usp=sharing H.264 1080p/24.000] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lEbFBzak1sbmU1N0E/view?usp=sharing H.264 1080i/25.000] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lEWDUzUVUtZEw4cDA/view?usp=sharing H.264 1080p/25.000] (MKV)
#[https://mega.nz/#!XI1yiKLA!rF4vweNo_xA7vpSzpLU-JctqfUGZN4vVU1m6WIJ5lT4 H.264 1080i/29.970 4:2:0@High 26Mbps] (C-Band satellite capture in MKV w/DTS-HD MA 2.0 audio, converted from E-AC3) ''(thanks alanisrox69)''
#[http://opencubetech.com/page47/ H.264 1080i/50.000] (download and change .mxf extension to .ts)
#[https://drive.google.com/file/d/0BwxFVkl63-lEbVptTVZ2NENURHM/view?usp=sharing H.264 1080p/50.000] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lEUGZnR1JHUUU0WEk/view?usp=sharing H.264 1080p/59.940] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lETTVtaVV0LUVRZ1k/view?usp=sharing H.264 1080p/60.000] (MKV)
#[https://drive.google.com/file/d/0BwxFVkl63-lETFVpOWRVVGNfeEU/view?usp=sharing VC-1 1080p/23.976] (MKV w/TrueHD 5.1 audio)
#[https://drive.google.com/file/d/0BwxFVkl63-lERnhlY1pHeW5wbjQ/view?usp=sharing VC-1 1080i/29.970] (MKV w/DTS-HD MA 5.1 audio)
#[https://drive.google.com/file/d/0BwxFVkl63-lETXlOa3hEMmVyZGM/view?usp=sharing MPEG2 1080i/29.970] (U.S. ATSC OTA capture, muxed into MKV w/DD5.1 audio)
#[https://mega.nz/#!GJMAADTK!deabwHlqtw2I_ihoY6_0xnxT_1W_d3jpAjnANKRBAzE MPEG2 4:2:0@High 1080i/29.970 36Mbps] (C-Band satellite capture in TS w/DTS-HD MA 5.1 audio, converted from E-AC3) ''(thanks alanisrox69 for #13-15)''
#[https://mega.nz/#!jREAxYgb!MtjBIh1oSJJBZgLT7AcdG88hGCFG-ak7pC2AyjrsaIQ MPEG2 4:2:0@High 720p/59.940 20Mbps] (C-Band satellite capture in TS)
#[https://mega.nz/#!c9dhAaKA!MG5Yi-MJNATE2_KqcnNJZCRKtTWvdjJP1NwG8Ggdw3E MPEG2 4:2:2@High 1080i/29.970 35Mbps] (C-Band satellite capture in TS w/DTS-HD MA 5.1 audio, converted from E-AC3) (most media players can't play this; Sigma SoC-based media players and Intel i3+ NUC's/HTPC's can)
#[https://www.dropbox.com/sh/6iy4gxgsfn14opq/AAAK_L1M_NwZwBPb5IkEPh7Ga?dl=0 Hi10 Anime Samples] ''(thanks Morien)''
#H.265 1080p (medium bitrate) Test #1 [https://drive.google.com/file/d/0B3-obtCH8dE8d04yQnY5ZkFJdVE/view?usp=sharing in ISO], and [https://drive.google.com/file/d/0B3-obtCH8dE8V0NXdi1Jd3NrNkk/view?usp=sharing in MKV] ''(thanks Mike for #16-17)''
#H.265 1080p (medium bitrate) Test #2 [https://drive.google.com/file/d/0B3-obtCH8dE8UnZiV2kyRGZEWW8/view?usp=sharing in ISO], and [https://drive.google.com/file/d/0B3-obtCH8dE8bFdvWVFUMlNjX0E/view?usp=sharing in MKV]
#[https://drive.google.com/file/d/0BwxFVkl63-lEbWhqS284RkpNMXc/view?usp=sharing 2D Forced Subtitles Sample #1 (SRT)]
#[https://drive.google.com/file/d/0BwxFVkl63-lEVEluSFZ4NlhpLUk/view?usp=sharing 2D Forced Subtitles Sample #2 (PGS)]
#3D Subtitles (use clip #2 in '3D Test Clips' section above)

==4K (UltraHD)==
{{note|To download, hover over link:
* If demo-world, click to go to site, then right-click thumbnail of video there & choose 'Save link as...' to download
* For any YouTube video, [https://www.4kdownload.com/products/product-videodownloader use this free tool] to download in original quality}}

#[https://drive.google.com/open?id=0BwxFVkl63-lEY3l3ODJReDg3RzQ H.264 29.970fps, 51Mbps] (in MOV, hdmkv's iPhone 6S raw 4K footage)
#[https://www.youtube.com/watch?v=Ppz41EmaJyU H.264 30.000fps] (in MP4, 4K Test Patterns) (YouTube) ''(thanks hansolo)''
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=111 H.264 50.000fps] (in MP4, Astra DVB satellite capture sample)
#[http://www.demo-world.eu/download-2d-trailers-uhd/?file=samsung_seven_wonders_of_the_world_china_uhd-DWEU.mkv&pic=samsung_seven_wonders_of_the_world_china.jpg H.264 59.940fps] (in MKV)
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=101 HEVC 8-bit 29.970fps] (in MP4)
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=45 HEVC 10-bit 23.976fps] (in TS)
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=96 HEVC 10-bit 59.940fps] (in TS)
#[https://drive.google.com/open?id=0BwxFVkl63-lEdVBuZkltckdZZ0k HEVC 10-bit 59.940fps] (Korean ATSC 3.0 satellite TV capture sample)
#[http://hdrsamples.com/ HDR 10-bit HEVC 24.000fps] (in MP4, 'Exodus' and 'Life of Pi' samples)
#[https://drive.google.com/open?id=0BwxFVkl63-lEdU9Ma0VYc3YxSVE HDR 10-bit HEVC 25.000fps] (in TS, Astra DVB satellite capture sample; no audio) ''(courtesy WeTek)''
#[http://demo-uhd3d.com/fiche.php?cat=uhd&id=144 HDR 10-bit HEVC 59.940fps] (in MP4, Camp by Sony)
#[https://drive.google.com/open?id=0BwxFVkl63-lEc3k0aldZaGtaVm8 DolbyVision 10-bit HEVC 23.976fps] (in TS, LG Comparison Demo) ''(thanks soyhakan)''
#[https://drive.google.com/open?id=0BwxFVkl63-lEWmNWcGl4eVRWS2M DolbyVision 10-bit HEVC 23.976fps] (in TS, LG Trailer) ''(thanks soyhakan)''
#[https://www.youtube.com/watch?v=s6zR2T9vn2c VP9] (open-source alternative to HEVC) (YouTube)
#[https://mega.nz/#!hJdFEIBI!uSOjZtkkjIVYSfqD9aSfONf1yq__uQvlsf47pCtFvdQ VP9 Profile 2 HDR #1] The World in HDR (in MKV, downloaded from YouTube) ''(thanks wesk05)''
#[https://mega.nz/#!pQEGgRwY!pD9whIlM-U9tJIA-LojxSt582BAZGfdSA5wAQLT06I4 VP9 Profile 2 HDR #2] The Redwoods (in MKV, downloaded from YouTube) ''(thanks wesk05)''
#[https://www.youtube.com/watch?v=nRt4Duf7GoI 5K (5120x2700) 60.000fps] (in MP4) (YouTube)
#[https://www.demolandia.net/downloads.php?id=60876578 HEVC 10-bit 23.976fps] (in MKV)
#[https://www.youtube.com/watch?v=ChOhcHD8fBA 8K (7680x4320) 29.970fps] (in MP4) (YouTube)
#[https://www.demolandia.net/downloads.php?id=73498539 HEVC 10-bit 23.976fps] (in MKV)
#[https://www.demolandia.net/downloads.php?id=99364567 HEVC 10-bit 23.976fps] (in MKV)

==Bitrate Test Clips==
Media players should be able play 70Mbps or better smoothly, w/o stutters for full 1080p, and 108-128Mbps for full 4K

*[http://jell.yfish.us/ Jellyfish, up to 400Mbps] (in H.264 and H.265 HEVC MKV) ''(thanks ScottAllyn01 for your useful site)''
*[http://dl.ganjanetwork.ru/Files/Video%20Test%20Files/Bitrate/Birds/ Birds, up to 90Mbps] (in H.264 MKV or M2TS)

==Resources for Additional Test Clips or Samples==

*[http://bbb3d.renderfarming.net/download.html Big Buck Bunny] (test suite with 2D, 3D and 4K clips)
*[http://www.cnx-software.com/2010/03/17/where-to-get-video-audio-and-image-samples/ CNXSoft's samples/links]
*[http://www.w6rz.net/ W6RZ MPEG2 clips]
*[http://thedigitaltheater.com/index.php/dolby-trailers/ The Digital Theater] (several Dolby ATMOS clips)
*[http://www.demo-world.eu/2d-demo-trailers-hd/ Demo World trailers] (several directly linked to above)
*[https://www.koi-sama.net/files/hi10/ AVC High 10 Profile Anime Samples] ''(thanks Morien)''
*[http://4ksamples.com/ 4Ksamples.com] (movie, sport, nature clips in 4K)
*[https://www.youtube.com/watch?v=k_okcNVZqqI&list=PLD33E5618740295DF Jacob + Katie Schwarz: We See the World in 4K] (beautiful 4K nature videos) (YouTube)
*[https://www.youtube.com/user/aroundtheworld4k Around the World 4K] (Cities worldwide in striking 4K) (YouTube)
*[https://www.youtube.com/channel/UCW35MLO96M_UVG7YzMt1I2A/videos Cities in 4K] (Similar to above) (YouTube)
*[https://www.youtube.com/channel/UC_3n6GTFuC4tTAojueLBTHg/playlists Manufacturer and other demos in 4K] (YouTube)
*[http://www.imaging-resource.com/news/2014/11/19/samsung-nx1-4k-video-samples-and-new-full-res-frame-grabs-available-for-do Imaging Resource 4K Samples] ''(thanks Karnis)''
*[https://www.youtube.com/channel/UCve7_yAZHFNipzeAGBI5t9g/videos The HDR Channel] (YouTube)
*[http://demo-uhd3d.com/ Demo UHD 3D] (various H.265 & H.265 4K clips) ''(thanks wrxtasy)''
*[https://x265.com/hevc-video-files/ x265 HEVC Samples]
*[http://www.evosiastudios.com/category/portfolio/films/ Evosia Studios] (several beautiful 1080p to 4K films)
*[http://www.libde265.org/downloads-videos/ libde265] (1080p to maxed-out 4K samples) ''(thanks Martijn)''
*[http://timestormfilms.net/ Timestorm Films] (4K to 8K videos)
*[http://samples.mplayerhq.hu/ MplayerHQ's library] (many clips)
::{{note|<code>http://samples.mplayerhq.hu</code> can even be added to Kodi as a video source, for easy loading, if you have a fast enough connection.}}

== Library samples ==

=== Ned's fake movie library ===
:A zipped collection of 1,000 empty movie files, with NFO files, poster, and fanart for each entry. Various movies from different years, including sequels/sets, remakes, movies named the same but unrelated, various genres, and so on. Useful for testing things like library scanning speed, library navigation, filtering, etc.

:* https://www.dropbox.com/s/llciqryeqqk4t70/Test%20video%20library.zip?dl=0

=== Music library ===
: Just the one album for now but hope to increase this over time. It's a complete album in MP3 format, tagged with Musicbrainz Picard ID3v2.3 (ID3v1 ID3v2.3) with extra genre, comment and composer tags for testing. Coverart is also included as a folder.jpg file. The album is licensed "Attribution-ShareAlike 3.0 Unported Creative Commons license" by the artist. You can download or pay for the album here if you like it. http://hungrylucy.com/album/pulse-of-the-earth

:* https://www.dropbox.com/s/rk8ue5fs49v5pnm/Creative_Commons_Music.zip?dl=0

=== Fake Sports TV Show library ===
: Here is a fake sports TV show library for use with the Kodi sports scraper. It includes a number of sports folders broken down into seasons and then events. This should work nicely with the current Sports TV scraper on the Kodi forums.

:* https://dl.dropboxusercontent.com/u/6798079/Downloads/Sports_fake_video_files.zip

=== Homebrew Game Roms ===
: This is a location to find a number of freely licensed "homebrew" console games that can be downloaded for testing with Kodi's upcoming retroplayer feature. They include NES, Gameboy and Snes titles.

:* https://github.com/OpenEmu/OpenEmu-Update/tree/master/Homebrew

== See also ==
* [[Video levels and color space]]

[[Category:Troubleshooting]]

Live TV Artwork

2017-12-03T21:15:02Z

Zag: Add TVheadend extra

{{Artwork_Contents}}
{{mininav|[[Artwork]]}}

= Introduction =
The Live TV section of {{kodi}} provides the facility to view Terrestrial TV through {{kodi}}. This allows you to view your local TV stations as though you were using a standalone Television or a TIVO type device. You are able to view Freeview type program guides, Record programs through Timer Rules and watch the recorded programs all without ever leaving {{kodi}}.

<section begin="intro" />{{Kodi}} provides the ability to insert the Logo of your TV Stations which then becomes visible in the program guide, on-screen displays and all channel listings, making it easy to distinguish each channel.<section end="intro" />

The two following images show some of the uses of the TV Logo's.

<gallery widths=500px heights=285px>
File:Artwork-TVLogo01.jpg|
File:Artwork-TVLogo02.jpg|
</gallery>

The following are the two methods for sourcing and applying logo's in {{kodi}}.

= TVLogo Add-on =
The easiest method of adding logo's to the Live TV section of {{kodi}} is by using the TVLogo Downloader add-on. <br />
:'''''See: [https://github.com/enen92/script.tvlogo.downloader/releases/tag/0.0.11beta script.tvlogo.downloader]'''''

This add-on is not currently in the official {{kodi}} repository. It must be downloaded from the above link and installed via zip file.

All logo's are downloaded from TheLogoDB, which is a scraper site for TV Station logos. <br />
:'''''See: [http://www.thelogodb.com/ TheLogoDB]'''''

If not all logo's are available using this method, you should consider contributing to the collection at TheLogoDB. Alternatively, use the Manual process to install the missing logo's.

= Manual Process =
The Manual Process of populating {{Kodi}} with logo's requires three steps:
#Source Logo's
#Save to local drive
#Load into {{kodi}}

== Source Logo's ==
Sourcing TV Station Logo's is relatively simple. Some commonly used methods to source logo's are:
*Google Image search
*Download from the official site of the TV Station
*Download from [http://www.thelogodb.com/ TheLogoDB Website]
*Create your own logo's

== Saving Logo's ==
Once you have sourced your logo's, they must be saved to your local hard drive. The images must conform to the image requirements detailed in the following two tables.

Note the following:
*The following two tables apply '''only''' to the logo's you have manually sourced and saved. It does not apply to logo's downloaded by the add-on in the previous section.
*The Aspect Ratios should be respected as the image fields within skins are not adjustable. Using incorrect ratios may lead to stretching, squashing or cropping of your logo's.

<div style="{{linear-gradient|bottom|#d8ffe2, #76c6f5}}">
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.png}}
| width=200px | {{nowrap|1.78:1}}
| width=200px | {{nowrap|800x450}}
|- valign="top"
| width=200px | '''or'''
|- valign="top"
| width=150px | {{nowrap|*.png}}
| width=200px | {{nowrap|1.:1}}
| width=200px | {{nowrap|450x450}}
|}
</div><br />

<div style="{{linear-gradient|top|#d8ffe2, #76c6f5}}">
'''''Naming and Saving conventions for your own manually sourced logo's:'''''

Logo's can be saved in any location as {{kodi}} does not search or scrape logo's. The only requirement is that the logged-in User has read permission for the folder where the logo's are saved.

</div>

== Loading Logo's ==
{{red|The following is based on NextPVR}}

From within {{kodi}} it is possible to manually add or remove logos by following these directions:

<gallery widths=400px heights=225px>
File:Artwork-TVLogo09.jpg|Image 1- Set the Logo folder
File:Artwork-TVLogo10.jpg|Image 2- Enable "Show Icons" option
</gallery>

:1. In the [[Settings/TV/Menu_OSD#Icons|PVR Settings menu]] set the folder which contains the logo's as shown in image 1
:2. Back to the PVR Homescreen, pull out the Sideblade menu and ensure "Show Icons" is enabled (image 2)

<gallery widths=400px heights=225px>
File:Artwork-TVLogo03.jpg|Image 3- Highlight channel to be modified
File:Artwork-TVLogo04.jpg|Image 4- Call up the Context menu and select '''Manage'''
File:Artwork-TVLogo05.jpg|Image 5- Select '''Channel manager'''
</gallery>

:3. From the TV Channel listing, highlight the channel that will have the logo set (image 3)
:4. Call up the Context Menu and select '''Manage''' (image 4)
:5. From the Manage Context menu, select '''Channel manager''' (image 5)

<gallery widths=400px heights=225px>
File:Artwork-TVLogo06.jpg|Image 6- Select '''Channel icon'''
File:Artwork-TVLogo07.jpg|Image 7- Select '''Browse'''
File:Artwork-TVLogo08.jpg|Image 8- Select '''Channel icons'''
</gallery>

:6. From the '''Channel manager''' page, scroll to the desired channel. Once the channel is highlighted, move to the right column and select '''Channel icon:''' (image 6)
:7. From the '''Browse for icon''' page, select '''Browse''' or other appropriate option (image 7)
:8. From the '''Browse for icon''' page, select '''Channel icons''' which is the folder you set in the Settings page in image 1 above (image 8)
:9. Select the appropriate logo and press '''OK'''

If loading multiple logos, repeat from Step 3.

{{red|The following is based on TVheadend}}

If you are using TVHeadend as your TV server, then it is possible to add logos using it's web admin interface.

You will need to host the logos somewhere on an internal web server or external.

Then you can add the logos in the "User Icon" field manager (TVHeadend web page >> Configuration >> Channel / EPG):

[[File:TVHeadend_logo.png]]

{{Top}}

<div style="{{linear-gradient|right|#d8ffe2, #76c6f5}}">{{next|[[PVR|Live TV Guide]]}} </div>

[[Category:PVR]]
[[Category:Live TV]]

{{updated|17}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Video library]]
[[Category:Advanced topics]]
[[Category:First time user]]
[[Category:Quick Start Guide]]

File:TVHeadend logo.png

2017-12-03T21:10:49Z

Zag:

HOW-TO:Estuary Modification

2017-11-08T22:27:47Z

Zag: /* More advanced edits */

HOW-TO:Estuary Modification

2017-11-08T22:26:24Z

Zag:

File:Estuary rating image control.jpg

2017-11-08T22:23:42Z

Zag:

File:Estuary rating mod4.jpg

2017-11-08T22:18:50Z

Zag:

File:Estuary rating mod2.jpg

2017-11-08T22:16:55Z

Zag:

Skinning

2017-11-08T21:15:36Z

Zag:

{{mininav|[[Development]]}}

{{Kodi}} is noted as having a very flexible and robust framework for its GUI, making theme-skinning and personal customization very accessible. Users can create their own skin (or modify an existing skin) and share it with others. ''[[Confluence]]'' is the official skin.

== General ==
{| width="100%"
|- valign="top"
| width="25%" align="center" | {{Main page icon|image=Nuvola apps kthememgr.png|link=Skin development introduction}}
| width="25%" align="center" | {{Main page icon|image=Applications-development.png|link=Skin structure|title=Skin structure}}
| width="25%" align="center" | {{Main page icon|image=Book icon 1.png|link=XBMC Skinning Manual|title={{kodi}} skinning manual}}
| width="25%" align="center" | {{Main page icon|image=Administration.png|link=Skin development tools}}
|}

== Tutorials ==
{| width="100%"
|- valign="top"
| width="33%" align="center" | {{Main page icon|image=Gnome-preferences-desktop-wallpaper.png|link=First skin tutorial}}
| width="33%" align="center" | {{Main page icon|image=Go-home-2.png|link=HOW-TO:Edit the home screen skin files|title=Home screen tutorial}}
| width="33%" align="center" | {{Main page icon|image=Inkscape icons dialog messages.png|link=HOW-TO:Make a dialog popup automatically with another one via skinning|title=Popup tutorial}}
|- valign="top"
| width="33%" align="center" | {{Main page icon|image=Weather-sun-clouds-some-rain.png|link=HOW-TO:Enable weather info display for the home screen via skinning|title=Weather info tutorial}}
| width="33%" align="center" | {{Main page icon|image=Crystal Project window list.png‎|link=HOW-TO:Add a new window or dialog via skinning|title=New dialog tutorial}}
| width="33%" align="center" | {{Main page icon|image=Crystal Clear app fonts.png|link=HOW-TO:Add a new true type font to the skin|title=Adding fonts tutorial}}
|- valign="top"
| width="33%" align="center" |
| width="33%" align="center" | {{Main page icon|image=Estuary-edit-icon2.png|link=Estuary Modification}}
| width="33%" align="center" |
|}

[[Category:Add-on development|*]]

File:Estuary-edit-icon2.png

2017-11-08T21:15:29Z

Zag:

HOW-TO:Estuary Modification

2017-11-08T21:13:52Z

Zag: /* Testing your enviroment */

Skinning

2017-11-08T21:09:28Z

Zag: /* Tutorials */

{{mininav|[[Development]]}}

{{Kodi}} is noted as having a very flexible and robust framework for its GUI, making theme-skinning and personal customization very accessible. Users can create their own skin (or modify an existing skin) and share it with others. ''[[Confluence]]'' is the official skin.

== General ==
{| width="100%"
|- valign="top"
| width="25%" align="center" | {{Main page icon|image=Nuvola apps kthememgr.png|link=Skin development introduction}}
| width="25%" align="center" | {{Main page icon|image=Applications-development.png|link=Skin structure|title=Skin structure}}
| width="25%" align="center" | {{Main page icon|image=Book icon 1.png|link=XBMC Skinning Manual|title={{kodi}} skinning manual}}
| width="25%" align="center" | {{Main page icon|image=Administration.png|link=Skin development tools}}
|}

== Tutorials ==
{| width="100%"
|- valign="top"
| width="33%" align="center" | {{Main page icon|image=Gnome-preferences-desktop-wallpaper.png|link=First skin tutorial}}
| width="33%" align="center" | {{Main page icon|image=Go-home-2.png|link=HOW-TO:Edit the home screen skin files|title=Home screen tutorial}}
| width="33%" align="center" | {{Main page icon|image=Inkscape icons dialog messages.png|link=HOW-TO:Make a dialog popup automatically with another one via skinning|title=Popup tutorial}}
|- valign="top"
| width="33%" align="center" | {{Main page icon|image=Weather-sun-clouds-some-rain.png|link=HOW-TO:Enable weather info display for the home screen via skinning|title=Weather info tutorial}}
| width="33%" align="center" | {{Main page icon|image=Crystal Project window list.png‎|link=HOW-TO:Add a new window or dialog via skinning|title=New dialog tutorial}}
| width="33%" align="center" | {{Main page icon|image=Crystal Clear app fonts.png|link=HOW-TO:Add a new true type font to the skin|title=Adding fonts tutorial}}
|- valign="top"
| width="33%" align="center" |
| width="33%" align="center" | {{Main page icon|image=Estuary-edit-icon.png|link=Estuary Modification}}
| width="33%" align="center" |
|}

[[Category:Add-on development|*]]

File:Estuary-edit-icon.png

2017-11-08T21:09:09Z

Zag:

HOW-TO:Estuary Modification

2017-11-08T21:01:49Z

Zag: /* Making your first skin edit */

HOW-TO:Estuary Modification

2017-11-08T20:55:34Z

Zag:

File:Estuary mod music8.jpg

2017-11-08T20:53:07Z

Zag:

File:Estuary mod music7.jpg

2017-11-08T20:47:33Z

Zag:

File:Estuary mod music5.jpg

2017-11-08T20:41:45Z

Zag:

File:Estuary mod music6.jpg

2017-11-08T20:38:11Z

Zag:

File:Estuary mod music4.jpg

2017-11-08T20:35:50Z

Zag:

File:Estuary mod music3.jpg

2017-11-08T20:31:24Z

Zag:

File:Estuary mod music2.jpg

2017-11-08T20:25:02Z

Zag:

File:Estuary mod music1.jpg

2017-11-08T20:20:56Z

Zag:

HOW-TO:Estuary Modification

2017-11-08T20:14:53Z

Zag: Add Structure of Estuary heading

HOW-TO:Estuary Modification

2017-11-08T20:05:30Z

Zag: Initial upload of page

File:Estuary-logo.png

2017-11-08T20:03:32Z

Zag:

File:Keymap xml.jpg

2017-11-08T19:58:09Z

Zag:

File:Skinners keymap kodi.jpg

2017-11-08T19:56:54Z

Zag:

HOW-TO:Screensaver addon

2017-09-26T09:18:38Z

Zag: /* Examples */

{{mininav|[[Development]]|[[Add-on development]]|[[Python development]]|[[Python examples]]}}
<br />

=Introduction=
This tutorial will explain how to write your first Kodi/XBMC Screensaver Add-on<br />

[[File:Screensaver.video.jpg]]

=Tools=

Screensavers should be pretty easy in their most basic form. All you will need is a text editor or IDE and some artwork resources.

=Examples=
Since we don't have a full "HOW TO" guide for this yet (please feel free to sign up to the wiki and edit this page) we will just show some source code of other screensavers for now:

'''Python examples'''

https://github.com/XBMC-Addons/screensaver.picture.slideshow

https://github.com/vdb86/screensaver.digitalclock

'''C++ example'''

https://github.com/notspiff/screensaver.stars

You can either download as a zip and install both of these inside the kodi GUI from the install from zip feature. Or extract the zip into your userdata/add-ons folder.

=Extra info=

Check out the forum section for Screensavers and Visualisations

http://forum.kodi.tv/forumdisplay.php?fid=38

[[Category:Add-on development]]

HOW-TO:Visualisation addon

2017-09-26T09:18:10Z

Zag: /* Installing */

{{mininav|[[Development]]|[[Add-on development]]|[[Python development]]|[[Python examples]]}}
<br />

=Introduction=
This tutorial will explain how to write your first Kodi/XBMC Visualisation Add-on<br />

[[File:Vortex3.png]]

=Tools=

Visualisations are quite complicated so you probably want to have a graphics editing package such as GIMP(https://www.gimp.org) installed for when you need to resize or crop textures or image backgrounds.

Video editing software may also be useful but that is beyond the scope of this tutorial.

=Installing=
Since we don't have a full "HOW TO" guide for this yet (please feel free to sign up to the wiki and edit this page) we will just show some source code of other visulisations for now

https://github.com/wsnipex/visualization.projectm

You can either download as a zip and install both of these inside the kodi GUI from the install from zip feature. Or extract the zip into your userdata/add-ons folder.

=Extra info=

Check out the forum section for Screensavers and Visualisations

http://forum.kodi.tv/forumdisplay.php?fid=38

[[Category:Add-on development]]