Qtv pools youTube playlists, organizes their data into a guide structure, and adds exceptional functionality for managing the navigation and playback of the videos contained within. It is highly advised that you read this entire documentation at least once, as there are numerous possibilities of a non-obvious nature and it is unlikely that you will discover many of them by chance.
Qtv was built and heavily tested using the latest Mozilla Firefox browser. By observation, it also works very well in the Google Chrome browser but, extensive tests have not been performed in that browser. Other browsers, such as: Opera and Safari were quickly audited but have recieved no official testing. Internet Explorer was completely ignored in every regard. Whereas Qtv scales to incredibly small percentages, as of yet there has been no mobile testing, and it can be assumed that I expect mobile to have usability issues.
If you would like to report a bug, feature request or other issue you are welcome to do so here. However, if you have a bug or other crippling issue in Internet Explorer, filing a report will be a waste of your time because, I have no intention of ever catering to the standardless expectations of that browser. Bug or issue reports for any other browser are welcomed and will be addressed as they arise.
Thank you, for using my application and I hope you enjoy your experience.OneMadGypsy
The guide is the primary element in the lower quarter of the page and the entire point of this application. Playlists are aggregated and expanded into the individual listings in the guide. The guide is a powerful tool and understanding it's features will enhance your viewing experience.
The channel controls consist of three elements.
1) the channel slug (ie. 100 ABCD): The channel slug is a clickable button that can be used to (un)ignore entire channels. This is helpful if you are in random autoplay mode but do not want certain channels to be chosen at random. If a channel is being ignored, it's slug will turn dark grey indicating that it is inactive. It is still possible to cue and play episodes from ignored channels but, episodes will never be selected automatically from an ignored channel.
2) slide left: Clicking the slide left control will slide the entire channel listing to the left by up to 90% of the guide width, based on the nearest video that does not exceed that amount.
3) slide right: Clicking the slide right control will slide the entire channel listing to the right by up to 90% of the guide width, based on the nearest video that does not exceed that amount.*Both the slide left and slide right controls will be greyed out if it is not possible to go any further in their respective direction.
There are 5 play states: cued, active, buffering, paused and playing. For the purpose of this document, any video that is marked playing, paused, active or buffering is considered to be the active listing, and cued listings are considered to be the cued listing. Upon app instantiation a random video is automatically put in the actual "active" state. Clicking a listing that is in the "active" state will begin the playback of that video. If a video needs to buffer the active listing will be put in the buffer state. You can play/pause a video by clicking the active listing or through the normal youTube controls. Clicking any completely inactive listing in the guide will cue it. Clicking a cued video again will dump the currently active listing and make the cued listing the currently active one. If autoplay is toggled on the video will automatically begin playback. More on the autoplay feature later in this document.
The information panel contains data and suggestions regarding selected video listings, as-well-as the documents for this application.
The arcade is part of the initial display of Qtv and is the first tab display to the right of the video player. The arcade features the main image for the currently active video and 3 image links to randomly selected videos within the channel that contains the currently active video. Hovering any image in the arcade will produce a tooltip that displays the entire title for it's corresponding video. Clicking any of the 3 "similar video" image links will cue the video the selected image corresponds to, and populate the catalogue with all the information that corresponds to the cued video.
The catalogue acts as the main information display for selected videos as well as a search console. Active and selected videos display their thumbnail, publish date and description in the catalogue. It is possible to paginate through the catalogue within the listing of an active channel, as-well-as paginate through search queries made on the entire guide.
The video pagination arrows are located in the upper left corner of the catalogue. Paging left or right through the videos will load all of the information for the current video in the catalogue and cue the video that corresponds to the currently displayed data. Pagination works on a loop and exceeding either extreme of a channel list will revert to the other extreme. You can use the left and right arrow keys to page, as well but, if the search box has focus (ie. the caret is in it) then arrow keys revert to paging search results (if any). Basically, if arrow keys aren't working for regular paging, click anywhere on the page that is not the search box and try again.
Using the search widget will search all titles and decriptions for your request. In the case where one video has your request in both the title and description those 2 results are merged so, you will never have duplicate results. Clicking the search box will clear it but, it will not clear the search results. You can still page through search results after clearing the box. Pressing enter or the "go" button does clear the current results and queries fresh ones as long as you have at least 1 character in the search box. You can use the arrows to either side of the search box or the left and right arrow keys on your keyboard to page through search results. However, in order for the arrow keys on your keyboard to have effect the search box must have focus (ie. the caret must be in it). Failure to make sure the search box has focus and attempting to use the arrow keys to page the results will result in you paging through the currently active channel so, always make sure you have a caret in the search box (ie. click it) before attempting to use the arrow keys to page. If you pressed enter to make your query the search box should already have focus.
The controls bar resides above the bottom quarter of the page. It displays the currenty active listings title and all of the controls that are complimentary to the standard channel controls. Controls tend to have functionality that is dependent on the state of other controls. Controls can be initiated by click or via keyboard shortcuts. None of the controls in the control bar relate directly to the youTube player. The youTube player is inteded to be controlled via it's own interface and/or by the available controls in the guide.
The effects volume slider controls the volume level for the application sound effects. You can control this with your keyboard, as well, by pressing Shift & Up Arrow (volume up) or Shift and Down Arrow (volume down). You can also toggle mute the volume by pressing Shift + M. If the volume is muted it can also be unmuted by clicking the volume slider. To control the video playback volume use the standard player controls that are embedded in every youTube video.
Clicking the "show" icon toggles the guide and the catalogue information between the currently active and currenty cued video selections. If no video is cued it will just keep resetting the guide and catalogue to the active video information. That being said, it is rarely necessary to click this button if there is no cued video.
Clicking the "skip" buttons will skip to the next or previous video (respectively). However, if you have "random" toggled on, both buttons will just randomly select a video from the entire non-ignored portions of the guide with directions being completely ignored. If you also have "playlist" toggled on, pressing the "skip" buttons will skip to a random video within the currently playing playlist. Directions are also ignored in playlist mode but, this may change in the next release.
With the "playlist" switch selected, making selections will load the entire playlist and start it from the video you selected. Toggling off the "playlist" switch will embed the standard video player once your current video has ended.
With the "random" switch selected, videos will be selected at random across the entire spectrum of the non-ignored portion of the guide. If you also have the "playlist" switch selected, videos will be selected at random within the available videos for the current playlist. Toggling the "random" switch off will result in the player selecting videos concurrently within a channel until a point where it has reached the end of the channel listing. At that point, whether the "random" switch is toggled on or not a new channel and video will be selected at random unless a video has been cued. In which case the cued video will begin.
With the "autoplay" switch selected, videos will continuously stream. As each new video is initiated it's title will be displayed in the control bar, all of the video information will be displayed in the catalogue, an instance of the video thumbnail will be displayed in the arcade and 3 image links to other random videos from that channel will be displayed under it. If a channel reaches the end of it's video list, a new channel will be auto-selected for you and all concurrent videos will continue to play. Toggling off the "autoplay" switch will require that you manually start every video.
With the "hide" switch selected, everything except the control bar and the video player will be removed from the screen, creating an almost "full window" display. Toggling the "hide" switch off will return the display to it's initial state.