TouchJams



????TouchJams???1. Introduction????Welcome to?TouchJams Help???Hot Topics ?HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\Activation.htm"Program Activation Music Tag Info Tutorial: Adding a New Language to TouchJams Tutorial: Custom?Display Text Within TouchJams?????2. FAQ2.1 Program Activation/VerificationProgram Activation/Verification?After making your TouchJams purchase, you?will need to activate the product using your Product Key?before you can start using it.? TouchJams supports?2 different types?of program activation/verification:??Internet and Manual.? If the machine which will run TouchJams generally has Internet access, then it's recommend that you choose Option 1 below -?Internet -?as it's the easiest and quickest way to start using TouchJams.? If the machine which will run TouchJams will have?little or no Internet access, then you should choose Option 2 below - Manual.?Activation/Verification TypeDescription??1 - Internet (Internet access)Use this?when the machine running TouchJams has?Internet access.? The machine doesn't need to have Internet access 100% of the time, but should have access to the Internet most of the time. To continue, please click HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\Internet_Activation.htm"here.??2 - Manual(limited Internet access)Use this ONLY when you intend to run TouchJams on a machine which will have little or no Internet access.??Internet access will?not be required?after?TouchJams has been activated through this type of activation.? To continue, please click here.?2.1.1 InternetInternet?Activation/Verification?To activate TouchJams over the Internet, it is assumed that you have already installed the Full version of TouchJams, and that you have your Product Key.? Please follow the below steps after you have launched TouchJams for the first time. Step 1?Enter your Product Key.? Your Product Key should look something like TJSSTD-XXXX-XXXX-XX.Step 2?When this window appears, simply hit the OK button, and if all goes well, TouchJams should now be ready for use.2.1.2 ManualManual Activation/Verification?To manually activate TouchJams, it is assumed that you have already installed the Full version of TouchJams, and that you have your Product Key.? Please follow the below steps after you have launched TouchJams for the first time. Step 1?Enter your Product Key.? Your Product Key should look something like TJSSTD-XXXX-XXXX-XX.Step 2?When this window appears, simply hit the Cancel button and continue to the next step.Step 3?Within this window, select Manual Activation.Step 4?This step involves obtaining a code for your Product Key and Installation Code.?There are 2 different ways in which you can obtain the code for your Product Key and Installation code.? If you have access to a computer with an Internet connection, you can retrieve the code yourself, which is the quickest method.? If you do not have access to a computer with an Internet connection, you will have to email support at TouchJams.?1)? I do have access to a computer with an Internet connection:Click on the following link: HYPERLINK "" \t "_blank" here? When the web page appears, enter your Product Key and Installation code (see the red areas in the window above).? If you enter these correctly, the web page will give you a code which you then enter in to the bottom box of the window above, and hit OK.? If all information was entered correctly, your copy of TouchJams should now be ready for use.?2)? I do not have access to a computer with an Internet connection:In the red areas in the window above, please email the Product Key and Installation Code to support@, and you will receive a code which you will enter into the window to the left.2.1.3 FAQFAQ - Program Activation/Verification?Q: How?do I reset the program activation on my machine?A: click HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\Reset_Activation.htm"here ?Q: My machine is currently setup for Internet Activation/Verification.? My machine doesn't always have Internet access, what can I do?A: click here 2.1.3.1 Reset ActivationTo reset your TouchJams Activation, please follow the below steps:Navigate to the folder: Windows XPC:\Documents and Settings\All Users\ACH\TJSSTDWindows Vista/7/8C:\ProgramData\ACH\TJSSTDIf you are unable to locate this folder, please read the following:For Windows Vista/7/8, to make all folders visible, you will have to go to Control Panel/Folder Options/View tab, and select "Show hidden files, folders, and drives".Delete all the files and folders under the folder in red above.2.1.3.2 Change to Manual ActivationChanging From?Internet Activation/Verification to Manual Activation/VerificationPlease follow all steps in this document while you are connected to the Internet.? After completing all the steps in this document, TouchJams will no longer need an Internet connection to validate the Product Key.Using Explorer (not Internet Explorer), navigate to the folder where TouchJams is installed.? This should be in one of the two following locations:???? 1) C:\Program Files\TouchJams Standard???? 2) C:\Program Files (x86)\TouchJams StandardLocate the TouchJams.exe.cm.ini file in this folder.? Right-click this file, and from the popup menu select Edit.? This file should contain something like the following:?; This .ini file may only contain the path to the location of the real CopyMinder files.; Use a .cm.ini file in that location if you wish to change the CopyMinder settings.[Main]Path=C:\ProgramData\ACH\TJSSTD\cmThe text in red above may vary from one machine to the next, but whatever the text is on your machine, we need to navigate to this folder using Explorer.? If you are unable to locate this folder, please read the following:For Windows Vista and Windows 7, to make all folders visible, you will have to go to Control Panel/Folder Options/View tab, and select "Show hidden files, folders, and drives".Once you have navigated to the folder in red above, you should again find the TouchJams.exe.cm.ini file.? Again, right-clik on this file and select Edit from the pop-up menu.? This file should contain something like the following:?[Main]Trial=NeitherNetworkClientAllowed=NoProductKey=TJSSTD-XXXX-XXXX-XX[Messages]ShowWebCheckMessage=NOWe need to add a line to this file so TouchJams no longer wants to validate the key on the Internet.? The line you should add to this file is in red below:?[Main]ForceWebCheck=OnceTrial=NeitherNetworkClientAllowed=NoProductKey=TJSSTD-XXXX-XXXX-XX[Messages]ShowWebCheckMessage=NOAfter adding this line, save the file and close it.Start TouchJams, and then exit TouchJams.?***? IMPORTANT ***At this point contact support@ and indicate that you have made all of the changes above.? Your product key will need a settings change on the activation server, and after that is complete, you will be notified and you should continue with the below.?***?After you receive the above notification, start TouchJams, and then exit TouchJams.?At this point, TouchJams should now run without trying to connect to the Internet.? To test this, simply unplug your machine from the Internet and try running TouchJams.?2.2 Music Tag InfoTag Info?In order for TouchJams to organize your music library correctly and to provide accurate search capabilities, audio and video files should contain at a minimum the Artist, Album and Title tag info. ?Commercial Tag Editing SoftwareLinks to commercial tag editing software can be found HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\Tagging_Software.htm"here.Tag Info Text FileTo specify tag info, it is possible to use an external tag info text file.? Please clickhere?for information regarding this.?? 2.2.1 Tagging Software??Tag & Rename? HYPERLINK "" \t "_blank" product homepageKJ File Manager? product homepage??Jaikoz ?product homepageMP3Tag? product homepage??SongKong ?product homepage????2.2.2 Tag Info Text FileTag Info Text File?Another possibility to supply tag info to your music is by creating a tag info text file which pairs with your music file or video file.? To set this up, you simply create a text file in the same folder as your music/video file and name it the same name as the music/video file.? For example, say you have the music/video file called "C:\MySongs\311 - Welcome.MP3", you would create the text file "C:\MySongs\311 - Welcome.TXT", and the contents of this file should appear as:artist=311to download this file, click HYPERLINK "" \t "_blank" herealbum=Musictitle=WelcomeTo create this file, simply use NotePad which comes with Windows.? After creating this file, rescan either the music library or video library, depending on what type of song you just made the tag info text file for.2.3 KaraokeKaraoke Releated FAQs2.3.1 Karaoke CD+G FilesKaraoke FilesFor karaoke files, TouchJams is actually looking for ZIP files which contain the music file (typically MP3) and CDG file.? So, for each MP3/CDG file, you would put that file pair in a single zip file.? TJs is picky about the filenaming convention, and the MP3/CDG/ZIP files all need to have the same filename (less extension).??For example:???? ACDC - Back in Black.MP3???? ACDC - Back in Black.CDG???? ACDC - Back in Black.ZIPSo, for all your karaoke music, you'd want your file/folder structure to look something like:????? C:\music\karaoke\ACDC\Back in Black\ACDC - Back in Black.ZIP????? C:\music\karaoke\ACDC\Back in Black\ACDC - Hells Bells.ZIP?????? C:\music\karaoke\ACDC\High Voltage\ACDC - High Voltage.ZIP?????? C:\music\karaoke\ACDC\High Voltage\ACDC - The Jack.ZIPAs with the standard TouchJams library, you want all songs of the same album to be located in 1 folder.3. Program UpdatesTouchJams customers receive free program updates for life.For customers who purchased TouchJams v2.0 and after:?Simply download the latest version of TouchJams HYPERLINK "" here and run the install.For customers who purchased TouchJams prior to v2.0:?Email support@ and request the latest program version. Please provide any information that you can which shows that you are an existing TouchJams customer. Normally, just your email address is enough providing that it is the one you used when making the initial purchase.4. Update Library ErrorsUpdate Library Errors?After updating the TouchJams library, if any errors occur, the below window will be displayed.? ??To view more details about the errors, select the More Info button, and more information like the below will appear.??As shown in the window above, the most likely cause for an error to appear will be that the music file is missing certain tag fields.See Also: HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\Media_Library_Recommendations.htm"Media Library RecommendationsSetting Tag Info5. Media Library RecommendationsMedia Library Recommendations???? Your media library is only as good as it is organized. The following is recommend for your media library:1 - Tag Info - media files have at a minimum the Artist, Album and Title tags filled out2 - Folder Structure - media files are organized into folders which represent albumsBelow explains these 2 points in more detail. Tag Info In order for TouchJams to organize your music library correctly and to provide accurate search capabilities, audio and video files should contain at a minimum the Artist, Album and Title tag info. If a particular media file is missing any one of these 3 tag fields, a default value will be used:Tag FieldDefault ValueArtist"Unknown"Album"Unknown"Titlefilename less the folder and filename extensionFolder Structure Along with sufficient tag info, media files should be organized into folders on the storage medium being used. All the media files in a last child folder are treated as a physical album, or CD. The below example shows the right and wrong way to organize your media files:Wrong WayCorrect WayLocal Disk (C:)?? My Music????? Artist A - Best Of - Track X.mp3????? Artist B - Best Of - Track X.mp3????? ---????? Artist X - Best Of - Track X.mp3Local Disk (C:)?? My Music????? Folder 1???????? Artist A - Best Of - Track X.mp3????? Folder 2???????? Artist B - Best Of - Track X.mp3????? ---????? Folder X???????? Artist X - Best Of - Track X.mp3In the Correct Way illustrated above, all the files in Folder 1 will be treated as an album, and the same applies to Folder 2 and Folder X. However you choose to create the folder hierarchy in your media library, the concept to remember is that all files under each leaf folder will be treated as an album. 6. Uninstall TouchJamsUninstall TouchJams Simply running the TouchJams uninstall from the Control Panel will not completely uninstall TouchJams, as all the user generated data will remain.? To uninstall this data, you will need to manually delete the following folders:??? Windows XP - logged in as Administrator???? 1) C:\Documents and Settings\Administrator\Application Data\TouchJams???? 2) C:\Documents and Settings\All Users\Application Data\TouchJams? ??? Vista/7/8 - logged in as Joe???? 1) C:\Users\Joe\AppData\Roaming\TouchJams ???? 2) C:\ProgramData\TouchJams For Windows Vista/7/8, if you are unable to see these folders, you will have to go to Control Panel/Folder Options/View tab, and select "Show hidden files, folders, and drives".7. Protected Mode (Party Mode)Protected Mode (Party Mode)TouchJams offers a Protected Mode, or Party Mode, which is ideal for public settings, such as parties, bars & pubs, etc. When TouchJams is running in Protected Mode, buttons which gain access to program settings are hidden, preventing people from messing with the jukebox settings. At any time, TouchJams can resume Administrator Mode by double-clicking an area of the screen and entering a password.To setup TouchJams for Protected Mode, follow the below steps:from the main screen, select Options:System:Admin in the Startup Settings/Administrator Logout group, drop down the Profile list and selected Protected hit the Logout button after this, the below reminder window will appearIf you don't want to see this reminder window again, check the box "Don't Show This Again" Hit the Close button, and the jukebox is now in Protected Mode To exit Protected Mode and go back to AdministraFor additional security measures, the taskbar and Start menu can be hidden while in Protected Mode. To do this, follow the below steps:tor mode, please follow the steps:from the main screen, select Options:Appearance:View Settingsin the General Options section, check the box "Hide Taskbar In Protected Mode" 8. User Group Control PropertiesUser Group Control PropertiesTouchJams has 3 built in User Groups:? Administrator, Protected, and Supervisor.? For each of these groups, all controls (screen elements) can be shown or hidden, for each view mode (Album, Artist, Now Playing, etc.).? The fastest way to configure these user group controls is to setup a hotkey within TouchJams and then simply hover over a screen element, hit the hotkey, and the above?dialog will appear.*Important: The only way that the above dialog will appear is through a hotkey.? To setup the hotkey, go to?Options/System/Keyboard Mapping, and add the keyboard mapping "User Group Control Properties".? For help on Keyboard Mappings, please select HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\System-Keyboard_Mapping.htm"this .? Once this hotkey is setup, you can simply hover over a screen element and hit the hotkey.9. DocumentsIf you would like to download this entire manual so that you can print it, below are download links to assist you with this.Microsoft Word HYPERLINK "" \t "_blank" downloadAdobe PDFdownload?10. Program OptionsProgram Options ?10.1 LibraryLibrary?10.1.1 MusicMusic Library?Statistics??Total ArtistsTotal artists in library.?Total AlbumsTotal albums in library.?Total AlbumsTotal titles in library.?Sources?AddSelect this button to add a library source.? A library source specifies a folder where your media files are located.? After this is selected the following dialog will appear:? HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\LibrarySource.htm"click here EditThis will allow editing a library source.? After this is selected the following dialog will appear: click here DeleteSelect this button to delete a library source.Options?For Artist, replace"The X" with "X, The"Check this box to change the way TouchJams displays artists starting with the word “The”. For example, selecting this options changes “The Cars” to “Cars, The”. Update on StartupCheck this box to have TouchJams automatically update the music library when it starts. Not recommended for large music libraries.Enforce Minimum Tag InfoCheck this box to restrict TouchJams to only adding music to the library where the music files have at a minimum the Artist, Album, and Title tag info.? If this option is not checked, TouchJams will fill in missing tag info:? Artist becomes "Unknown", Album becomes "Unknown", and the Title becomes the filename less the folder and filename extension.Actions?Files To SkipFiles TouchJams should skip when updating the music library. Click here for additional information.Tag EditorLaunch the built-in tag editor.ExportExport the music database information to a delimited text file. ?UpdateUpdate the music library. Updating adds to, but does not reset the music library.ResultsSelect this option to view the Update library results.? After selecting this button, a list of files will appear, along with error codes and tag information.? Click here for additional information. ?ResetSelect this option to reset the TouchJams internal music library. This does not delete any music files. See Also: Update Library Errors Media Library RecommendationsSetting Tag Info 10.1.2 KaraokeKaraoke?Library?Statistics??Total ArtistsTotal artists in library.?Total AlbumsTotal albums in library.?Total AlbumsTotal titles in library.?Sources?AddSelect this button to add a library source.? A library source specifies a folder where your media files are located.? After this is selected the following dialog will appear:? HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\LibrarySource.htm"click here EditThis will allow editing a library source.? After this is selected the following dialog will appear: click here DeleteSelect this button to delete a library source.Options?For Artist, replace"The X" with "X, The"Check this box to change the way TouchJams displays artists starting with the word “The”. For example, selecting this options changes “The Cars” to “Cars, The”. Update on StartupCheck this box to have TouchJams automatically update the music library when it starts. Not recommended for large music libraries.Enforce Minimum Tag InfoCheck this box to restrict TouchJams to only adding music to the library where the music files have at a minimum the Artist, Album, and Title tag info.? If this option is not checked, TouchJams will fill in missing tag info:? Artist becomes "Unknown", Album becomes "Unknown", and the Title becomes the filename less the folder and filename extension.Actions?Files To SkipFiles TouchJams should skip when updating the music library. Click here for additional information.Tag EditorLaunch the built-in tag editor.ExportExport the music database information to a delimited text file. ?UpdateUpdate the music library. Updating adds to, but does not reset the music library.ResultsSelect this option to view the Update library results.? After selecting this button, a list of files will appear, along with error codes and tag information.? Click here for additional information. ?ResetSelect this option to reset the TouchJams internal music library. This does not delete any music files. See Also:Update Library Errors Media Library RecommendationsSetting Tag Info 10.1.3 VideoVideo Library?Statistics??Total ArtistsTotal artists in library.?Total AlbumsTotal albums in library.?Total AlbumsTotal titles in library.?Sources?AddSelect this button to add a library source.? A library source specifies a folder where your media files are located.? After this is selected the following dialog will appear:? HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\LibrarySource.htm"click here EditThis will allow editing a library source.? After this is selected the following dialog will appear: click here DeleteSelect this button to delete a library source.Options?For Artist, replace"The X" with "X, The"Check this box to change the way TouchJams displays artists starting with the word “The”. For example, selecting this options changes “The Cars” to “Cars, The”. Update on StartupCheck this box to have TouchJams automatically update the music library when it starts. Not recommended for large music libraries.Enforce Minimum Tag InfoCheck this box to restrict TouchJams to only adding music to the library where the music files have at a minimum the Artist, Album, and Title tag info.? If this option is not checked, TouchJams will fill in missing tag info:? Artist becomes "Unknown", Album becomes "Unknown", and the Title becomes the filename less the folder and filename extension.Actions?Files To SkipFiles TouchJams should skip when updating the music library. Click here for additional information.Tag EditorLaunch the built-in tag editor.ExportExport the music database information to a delimited text file. ?UpdateUpdate the music library. Updating adds to, but does not reset the music library.ResultsSelect this option to view the Update library results.? After selecting this button, a list of files will appear, along with error codes and tag information.? Click here for additional information. ?ResetSelect this option to reset the TouchJams internal music library. This does not delete any music files. See Also: Update Library Errors Media Library RecommendationsSetting Tag Info 10.1.4 Internet RadioInternet Radio?LibraryStatisticsTotal StationsTotal stations in library.LibraryFolderDrive/path where music files are locatedResetSelect this option to reset the TouchJams internal music library by deleting and then rebuilding the entire music database. This does not delete the music files themselves or affect the karaoke, internet radio, or video libraries. UpdateUpdate rather than rebuild the music library. Updating adds to, but does not reset the music library.Update on StartupCheck this box to have TouchJams automatically update the music library when it starts. Not recommended for large music libraries. ? 10.1.4.1 Add Radio StationAdd Internet Radio StationYou will need 2 things prior to adding the radio station:a) the radio station playlist filename.? This file will have a PLS, M3U, or WPL filename extension.b) an image to be associated with the radio station (this is what will appear in the TouchJams radio station list)?1) go to Options/Library/Radio2) hit Manage3) hit Add4) near the Image preview white box, there is a Folder icon, hit it and specify the image filename in step b) above5) for the Filename, hit the Folder icon and specify the play list filename specified in b) above6) fill in the Comments, Title, and select a Genre7) hit OK8) this brings you back to the window in step 1) above9) hit the Update button, then hit Close to close the options10.2 AppearanceAppearance?10.2.1 SkinsSkins??TouchJams has a fully skinnable interface.SelectApply the currently selected skin.ScaleScale an existing skin to a specific screen size.Edit SkinEdit an existing skin.RefreshSelect this option to refresh the appearance of TouchJams.DownloadDownload additional available skins.FolderDrive/path where the skins are located.10.2.1.1 TouchJams Skins 101TouchJams Skins 101 Setup Skin Related HotkeysTo help speed up the task of modifying a skin, you should setup a couple of hot keys within TouchJams.Go to Options/System/Keyboard Mapping, and add the following hotkeys:KeyActionDescriptionSShow Skin Control PropertiesThis will allow you to simply hover over a control with the mouse, hit "S", and the skin editor will popup with the control selected.GSelect SkinHitting this key will popup a mini skin selection window.? This is a fast way to change skins, and doesn't require going through the Options.????10.2.2 Album ArtAlbum Art??Album Art configuration settings.Album Art Cache?FolderDrive\path of the album art image cache filesResetResets the album art cache and forces it to rebuildManageManage album art filesAlbum Art Load Rules?Tag Info, Then Music File LocationUse tag info images if present before using images stored in the same path as the music fileMusic File Location, Then Tag InfoUse images stored in the same path as the music file, if present, before using tag info imagesUpdate Album Art?Copy Album Art to Music File Location?Save Album Art to Music File (MP3/WMA only)?Default Album Art FilenameDefault name for album art images located in the same path as music files.10.2.2.1 Manage Album ArtTouchJams Manage Album Art10.2.2.1.1 Album ItemsTouchJams Album ItemsThe TouchJams Album Items window allows the user to manage the album art for a particular album.? The album art which TouchJams displays for each album originates from 1 of 2 places: the image embedded within the song file's tag data (MP3s/WMAs), or an image located in the folder where the song file exists.? To control which place TouchJams will look first, set the Album Art Load Rules found under Options/Album Art.? Below explains the functionality of the above window.Tag InformationGroupThe Tag Information group lists all the songs for a particular album.? Clicking through the items in the list will show the album art which is embedded inside the song file (MP3s/WMAs only).Apply AllWith an item selected, the Apply All button will embed the currently selected item's image into all the rest of the song files.? This will only work with MP3s and WMA files.Tag InfoTo edit the tag info for the selected item, hit the Tag Info button.Album ArtTo automatically find the album art for the selected item, hit Album Art.? This will launch another window and discover album art from Amazon.Apply To export the selected item's embedded file image to the folder where the song file is located, hit the Apply button.??Folder InformationGroupThe Folder Information group lists the album art files which are located for the album being viewed.? The actual folder location is displayed within this group.ApplyThis will take the selected image file and embed it into the selected item in the Tag Information Group.Delete Hitting this button will delete the currently selected file.ImportSelecting this button will prompt for an image filename and then copy that file to the album's folder location.10.2.3 AdvertisementsAdvertisements??TouchJams has the ability to display advertisements.? These advertisements are simply images which are custom made.? When advertisements are to be displayed, TouchJams will rotate through the images each time an advertisement is to be displayed.EnabledCheck this box to display Advertisements while TouchJams is running.FolderDrive\path of the Advertisement images.10.2.4 Screen SaverScreen Saver??Screen Saver SettingsEnable Internal Screen Saver?Video Filename?Start After:?Enable for Protected Mode Only?Keep Aspect Ratio?Preview?10.2.5 Configure MonitorsConfigure Monitors???2nd Monitor Content?Nothing?Advertisements?Configure?Now Playing?Primary Monitor - Karaoke/Video?Show Album Art?Show Video?Secondary Monitor - Karaoke/Video?Show Album Art?Show Video?10.2.6 LanguageLanguage??TouchJams supports multiple languages, and ships with English - United States as the default language.? From the HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\Manage_Languages.htm"Language Manager, you can define new languages to use with TouchJams.? When defining a new language to use, an already existing language is used as a template, and the translation process works by simply hovering over controls with the mouse, and hitting a hot key to view the controls properties.For a tutorial on how to setup a new language, click here .??Default LanguageSelect the default language to use.Available LanguagesCheck the languages which you want to be able to toggle through on the main TouchJams window (this is not released yet ).ManageSelect this to view the Language Manager.? From within the Language Manager, you can add addition languages, delete, import, and export languages.? Click?here for help with the Language Manager.See Also:Language Options?Language Manager ?Add Language?Control Properties?Keyboard Mappings10.2.6.1 Language ManagerLanguage Manager??From within the TouchJams Language Manager, you can add languages, delete languages, and?import/export languages.??AddClick this?to add a new language.??For?help with the Add Language window, click HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\Add_Language.htm"here.DeleteTo delete the currently selected language, click this button.ImportAfter selecting the language file to import, a list of the available languages in the file will appear.? From there the selected languages will be imported.ExportThis will export ALL languages to file.?See Also:Language Options?Language Manager ?Add Language?Control Properties?Keyboard Mappings??10.2.6.1.1 Import Languages10.2.6.2 Add LanguageAdd Language??To add (or define)?another language to TouchJams,?select the new language name from the drop down list, and also select an already existing language to use as a template.? So for example, if you wanted to add (define)?the language "English - United Kingdom", you would use the template "English - United States" as both languages are very similiar.??New LanguageSpecify the new language that you want to define.?Template LanguageSpecify the language you want to use as the template.?See Also:HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\OptionsLanguage.htm"Language Options?Language Manager ?Add Language?Control Properties?Keyboard Mappings10.2.6.3 Control PropertiesControl Properties??Important: this window will only appear by selecting a preconfigured hot key.? Within Options/System/Keyboard Mapping, you would add the keyboard mapping "Control Properties".? For help on Keyboard Mappings, please select HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\System-Keyboard_Mapping.htm"this .??Control Text?DefaultThe default text for the control.CustomCustom text to appear within TouchJams.??View Skin PropertiesSelect this to launch the Skin Editor with this control selected.??NoteTo specify a line break within the text, enter "(nl)" where the line break is to occur.See Also:Language Options?Language Manager ?Add Language?Control Properties?Keyboard Mappings?10.2.6.4 Tutorial - Add a New LanguageTutorial:?Add a New Language to TouchJams??Add a New Language??Step 1From the main TouchJams screen,?select Options / Appearance / Language / Manage.Step 2You should now be in the Language Manager window.? Click the Add button.? Specify the "New Language" that you want to add, specify the "Template Language" that you want to base your new language from, and then hit the OK button.? Step 3You should see a window indicating that the language creation was successful.Step 4Close out all windows so that you are back to the TouchJams main screen.??Control Properties??A hot key will need to be configured to make use of the Control Properties feature.? The Control Properties is where the translated text will be entered.??Step 5From the main TouchJams screen,?select System / Keyboard Mapping.Step 6Click the Add button.? Select a "Keyboard Key" - you should use function keys here, and not 0 - 9 or A - Z.? F12 would be a good key to use.? Next, in the "Function:" list, select "Control Properties", and hit the OK button.Step 7Close out all windows so that you are back to the TouchJams main screen.??Language Translation??Step 8From anywhere in the TouchJams main screens, simply mouse over any text which you would like to translate, and hit the hot key which you specified in Step 6 above.? Once the Control Properties window appears, select "Default" and enter the translated text for the language you are working on.? Note that if you would like a line break in the text, specify a line break by entering "(nl)" - do not include the quotation marks. After you are finished, hit OK and repeat this step until all desired text is translated.??Submit Your Language Translation??Step 9From the main TouchJams screen,?select Options / Appearance / Language / Manage.Step 10Select the Export button, specify the filename to export the language data to.? After this file is created, simply email this file to HYPERLINK "mailto:support@" support@.?See Also:Language Options?Language Manager ?Add Language?Control Properties?Keyboard Mappings?????10.2.6.5 Tutorial - Custom Display TextTutorial:?Custom Display Text within TouchJams??Control Properties??A hot key will need to be configured to make use of the Control Properties feature.? The Control Properties is where the translated text will be entered.??Step 1From the main TouchJams screen,?select System / Keyboard Mapping.Step 2Click the Add button.? Select a "Keyboard Key" - you should use function keys here, and not 0 - 9 or A - Z.? F12 would be a good key to use.? Next, in the "Function:" list, select "Control Properties", and hit the OK button.Step 3Close out all windows so that you are back to the TouchJams main screen.??Change the Text??Step 4From anywhere in the TouchJams main screens, simply mouse over any text which you would like to change, and hit the hot key which you specified in Step 2 above.? Once the Control Properties window appears, select "Custom" and enter the new text.? Note that if you would like a line break in the text, specify a line break by entering "(nl)" - do not include the quotation marks. After you are finished, hit OK.See Also:HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\Program_Options_Appearance.htm"Language Options?Language Manager ?Add Language?Control Properties?Keyboard Mappings??????10.3 View Settings?10.3.1 GeneralView Settings??Below are the TouchJams general view settings:?General Options?Main Window Can MoveCheck this option to allow users to move the TouchJams main window. Uncheck this option to lock the main window.Show Taskbar IconCheck this option to show the Taskbar Icon.Scrollbars – Use Page ButtonsCheck this option to use Page Buttons on the Scrollbars. Using page buttons is recommended for large music libraries.Show Mouse CursorCheck this option to hide the mouse cursor in TouchJams.Hide Taskbar In Protected ModeChecking this option will hide the taskbar and start button when TouchJams is running in Protected (Party) mode. 10.3.2 Search ViewSearch View??Below are the TouchJams Search View settings.?Search View Options?Search Exact Phrase?Search All YearsCheck this option to allow the search to include all years.Search All GenreCheck this option to allow the search to include all Genres.Custom Search LettersInclude certain custom letters.10.3.3 Charts ViewCharts?View??Below are the TouchJams Charts View settings.?Top Played View?Popular ItemsThis number determines how many items are displayed in the Popular Items View.History ItemsThis number determines how many items are displayed in the History Items View.10.3.4 Recently Added ViewRecently Added?View??Below are the TouchJams Recently Added View settings.?New Songs View?DaysThis number determines how many days an added song is considered to be “new”.ItemsThis number determines how many newly added items appear in the new songs view.10.3.5 Genre View10.4 SoundSound?10.4.1 VolumeVolume Volume configuration settings.Volume ControlInternal PlayerAdjust this slider to set the internal player volume of TouchJams.Internet RadioAdjust this slider to set the internal player volume of the Internet Radios Stations.Sound Card MixerMaster VolumeThis sets the master volume of the installed sound card mixer.Wave VolumeAdjust this to set the wave volume of the installed sound card mixer. Note: this does not apply to Windows Vista or 7MiscellaneousVolume StepThis controls how much the volume will be stepped up or down in the main program interface.Save/Restore SettingsCheck this to have TouchJams remember/restore the volume settings on program startup/shutdown.Auto DJ VolumeEnabledCheck this to enable the Auto-DJ volume. This applies to songs being played by Auto-DJ only.%The percentage of the Volume Control/Internal Player value at which Auto-DJ music will be played at.Default Levels?Configure?10.4.1.1 Volume DefaultsVolume Defaults?????????????????????10.4.2 EQEQ TouchJams comes with a built in 10-band equalizer.PresetSelect this option to customize up to 3 preset equalizer setting choices. Changes made to the EQ band sliders will be automatically saved to the selected preset.EnabledCheck this box to enable the equalizer.FlatSelect this to set each EQ band to 0.10.4.3 Auto DJAuto DJ Auto-DJ configuration settings.Genre Filter EnabledCheck this to filter songs by selected genre.Genre Groups (HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\\\userguide\\images\\genre-groups-ss.png" \t "_blank"screen-shot)Select AllCheck all genre list items.Clear AllUncheck all genre list items.Year Filter EnabledCheck this to filter songs by selected year/decade. Select AllCheck all year/decade items.Clear AllUncheck all year/decade items.Auto-DJDisabledSelect this option to disable Auto-DJ JukeBoxSelect this option to enable the Jukebox Auto-DJRadioSelect this option to enable the Radio Auto-DJ. (with this option selected you may chose “random” radio stations or select specific stations.Build Auto-DJSelect this option to build the Auto-DJ song list based on selected genre and year criteria.10.4.4 Cross FaderCross Fader TouchJams comes with a built in cross fader which enables the currently playing song to fade out while the next song in the queue fades in. This allows for music to be constantly played with zero silence in between songs.EnabledSelect this option enable the Cross FaderSet Default ValuesSelect this option to reset all values to their default valuesFade Out EnabledSelect this option to enable Fade OutFade In EnabledSelect this option to enable Fade InFade Out TypeThe fade out type, Volume or Break Down?Mix Start From End?Fade In Seek Position?Fade Out Length?Fade In Length?Fade Out Delay From Mix Start?Fade In Delay From Mix Start?10.5 SystemSystem10.5.1 AdminAdministrator Options???Startup Settings/Administrator Logout?User?View???User ManagerClick this button to manage users and user groups.Click here for additional help.10.5.1.1 User Manager10.5.1.1.1 Add User10.5.1.1.2 Edit User10.5.1.1.3 User Group Manager10.5.1.1.3.1 Add User Group?10.5.1.1.3.2 Edit User Group10.5.1.1.3.2.1 Options Access 10.5.1.1.3.2.2 View Mode Controls 10.5.2 Music FilterMaster Jukebox Filter?Genre Filter EnabledCheck this to enable the Genre Filter.Genre Groups (HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\\\userguide\\images\\genre-groups-ss.png" \t "_blank"screen-shot)Select AllSelects all genre.Clear AllDeselects all genre.Year Filter EnabledCheck this to enable the Year Filter.Select AllSelects all year decades.Clear AllDeselects all year decades.10.5.3 Keyboard MappingKeyboard Mapping??Keys can be assigned to various TouchJams program functionality.? For example, the "U" key could be set to turn the volume up.AddAdd a keystroke mapping.EditEdit an existing keystroke mapping.DeleteDelete an existing keystroke mapping.10.5.4 HealthSystem Health??This option displays the general status of the memory resources being consumed by Windows overall.? If TouchJams appears to be non-responsive or sluggish, this System Health window may assist with diagnosing insufficient memory resources.Memory Available?PhysicalPercentage of physical memory being used.Page FilePercentage of Windows Page File being used.VirtualPercentage of the Windows Virtual Memory being used.LoadThe load of all Windows memory resources.? A value of 0 indicates no Windows memory resources are being used.? A value of 100 indicates that all Windows memory resources are in use.Application Logging?Verbose LoggingCheck this option?to enable verbose logging.? When this option is checked, application logging will begin immediately.? Logging information is stored in one of the two locations, depending on the flavor of Windows you are running:?XPC:\Documents and Settings\(logged in user)\Application Data\TouchJams\(version)?Vista/7/8C:\Users\(logged in user)\AppData\Roaming\TouchJams\(version)?This logging folder can contain one or both of the below files: ?CurrentApplicationLog.binPreviousApplicationLog.bin??The information stored in these log files is encrypted and can't be read by a simple text file viewer.? Because of this, to have log files analyzed, they must be sent to: support@. 10.5.5 Remote ControlIR-Remote??TouchJams has built-in support for the USB-UIRT IR Remote hardware/software sold through the website ? This hardware will allow virtually any IR-Remote to be used with TouchJams.USB-UIRT IR Remote?Driver VersionIf the USB-UIRT driver has been successfully installed, the driver version will be displayed.? If the driver has not been installed correctly, or TouchJams is unable to initialize the already installed driver, error text pertaining to the error will be displayed mand Codes?AddAdd a new remote code function.EditEdit an already existing remote code function.DeleteDelete an already existing remote code function.10.5.6 Import MusicImport Music???Manually Import Music?FolderDrive\path to export music database file.Import?Automatic Import Music?Automatically Detect and Import USB Media?Prompt Before Importing?Ignore Drives Larger Than?Music Folder/Filename Convention?Type(library folder)\ARTIST\ALBUM\ARTIST - TITLE.(ext)??(library folder)\ARTIST\ALBUM\ARTIST - TITLE.(ext)??(library folder)\ARTIST\ALBUM\ARTIST - TITLE.(ext)??(library folder)\ARTIST\ALBUM\ARTIST - TITLE.(ext)??10.5.7 Export MusicExport Music??Export Music?FolderDrive\path to export music database file. 10.5.8 TimersTimers??All the above time values are displayed as Hours:Minutes:Seconds.Tenths of Seconds.Idle?Check Idle EveryFrequency at which TouchJams checks for idle state.Start Idle State AfterThe amount of time which must expire before entering the idle state.? While in the idle state, TouchJams will rotate through the following display views:? Now Playing, Song Spotlight and Advertisements.Idle State Actions?Show Now Playing ForThe amount of time to display the Now Playing view.Show Song Spotlight ForThe amount of time to display the Song Spotlight view.? This view randomly displays songs which have already been played.Show Advertisements ForLength of time to display advertisements.? For help with setting up advertisements, click here.Start Auto DJ AfterLength of time to expire before starting Auto DJ mode.? For help with setting up Auto DJ, click here.Misc?Update Player Position Every?Show Confirmations For?10.5.9 Network Remote ControlNetwork Remote Control??TouchJams has a built-in web server which allows browser enabled devices to remotely control TouchJams over a network.? Such browser enabled devices are laptops, net-books, tablets, PCs, and cell phones.? After enabling the TouchJams web server, you can simply enter the connection address into your browser and remotely control TouchJams.?Web Server EnabledCheck this option to enable the web server.? After selecting this option, Windows may raise a security alert - see HYPERLINK "" \l "Windows_Firewall_" Windows Firewall below.Port NumberThis is the port number which TouchJams will communicate over.ConnectionThis is the actual address which you enter into a browser to remotely control TouchJams.Server TemplatesSelect which server template to use.? Currently there are two available server templates to choose from:? 480 x 800 and 340 x 240.? Each of these templates are for screen sizes as indicated by their names.Web Server Client Configuration?To configure your laptop, PC, or cell phone to access the TouchJams web server, please see Configure Web Server Client.Windows Firewall ?When enabling the TouchJams web server, the below window may appear.? To enable the TouchJams web server, you must select "Allow access" below. ?10.5.10 Playlist OptionsPlaylist Options??TouchJams facilitates various queue options, such as how to insert music into the queue and how often a song can be played.Queue Add Operation?Random InsertCheck this option to randomly insert selected songs into the play queue.Append To EndCheck this option to add selected songs to the end of the play queue.Same Song Play Detection?EnabledSelect this option to limit how many times a particular song can be played in the selected time period.Limit Play to X TimesEvery Y HoursUse these two settings to set how often a song can be added to the queue.10.5.11 Scheduled EventsScheduled Events10.5.11.1 Day TimeScheduled Item - Day/Time 10.5.11.2 Auto DJScheduled Item - Auto DJ10.5.11.3 PlaylistScheduled Item - Playlist?10.5.11.4 SkinSkin10.5.11.5 Screen SaverScheduled Item - Screen Saver10.5.11.6 MiscScheduled Item - Misc10.5.12 Custom Command10.5.13 BetaBriteBetaBriteAdd: This will let you add a action.? Please see HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\BetaBriteEditAction.htm"here.??10.5.13.1 Edit ActionBetaBrite ActionEvent Type?Nothing PlayingNothing is playing in the TouchJams.Song PlayingA song is currently playing.Song StartA song has just started to play.Song EnqueuedA song has just been added to the Jukebox PlaylistAdvertisementAn advertisement is currently being displayed.Music ChartA music chart item is currently being mand:Display Time:Display Type:Rotate, Hold, Flash, Roll Up, Roll Down, Roll Left, Roll Right, Wipe Up, Wipe Down, Wipe Left, Wipe Right, Scroll, Auto, Roll In, Roll Out, Wipe In, Wipe Out, Compressed, Twinkle, Sparkle, Snow, Interlock, Switch, Slide, Spray?DescriptionTagColors{RED} {GREEN} {AMBER} {BROWN} {ORANGE} {YELLOW} {RAINBOW} {MIXED} {AUTO}Date & Time{TIME} {DATE}???10.5.14 Video OptionsVideo Options10.6 Revenue10.6.1 Coins-BillsIf you try to enable "Unique Keycode" or "Pulse Increment" above, you may receive the error message that "kbhk32.dll" is missing.? This DLL does not get installed by default because some virus software looks at this DLL as a threat.? What this DLL actually does is intercept key strokes coming into Windows.? The reason for this is that TouchJams expects the dollar bill acceptor/hardware to behave like a keyboard, where every time a bill is inserted, a keystroke is sent to Windows.? To intercept this keystroke, TouchJams has to use this keyboard hook so that it will 100% of the time register credits being put into the jukebox.To download?kbhk32.dll, please click HYPERLINK "" here.? You will need to place this in the same folder as the TouchJams.exe file, typically located under C:\Program Files\TouchJams or C:\Program Files (x86)\TouchJams.?If you need further assistance with this or have any questions, please contact TouchJams Tech Support at:? support@10.6.2 Reports10.6.2.1 Counters Report10.6.2.2 Revenue Report10.6.3 Revenue Options11. About TouchJamsAbout TouchJams This options windows shows information about TouchJams.????????????????????????12. Misc12.1 Skip Files ListSkip File List??The Skip File List displays the list of files which TouchJams will skip when updating the library.AddAdd a file to the list.RemoveRemove the selected file from the list.HelpDisplays this help topic.CloseCloses the Skip File List window.12.2 Catch File CrashUpdate Library Error?When updating the TouchJams library, unforeseen conditions may cause TouchJams to shut-down, or crash.? While this is not a common occurrence, the most likely reason for this to happen is the presence of corrupt music files.? So, in the event that TouchJams crashes while updating the library, simply restart TouchJams and the below information window will appear.? ??At this point, TouchJams has already added the problematic file to a list of files to skip in the future so that an unexpected shut-down is diverted.? For more information on the Skip File List, please click HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\skipfilelist.asp"here.12.3 Library SourceLibrary Source12.4 Update Library ResultsUpdate Library Results?Close?Tag Info?Explorer?Help?View All?Error CodeError Description0no error - file was successfully added to the TouchJams Library1item already exists2out of Memory3invalid database ID4tag info load error5missing tag info6invalid karaoke filename12.5 TouchJams National Music ChartsTouchJams National Music Charts The TouchJams National Music Charts contain a list of the most popular music being played by the TouchJams community.? These charts can be displayed right from within TouchJams.If you want to contribute to these charts, each time a song is played information about the song will be sent to the TouchJams Music Chart Server.? This server?tracks what songs are being played, and from this?creates?the National Music Charts for all?participating countries.12.6 Hide Control ElementsHide Control Elements Options/System/Admin - User Manager - GroupsHighlight the user Group which you want to modify, and click the?Edit button.? For example, if you want to show/hide a control in Party (Protected) Mode, you would select the Protected group.From the User Group Properties window, click View Controls.From here, you can select the View Mode, and show/hide the view control in question by checking/unchecking items in the View Mode Controls list.So, for example you want to hide the Up/Down volume controls, along with the current volume level.? In the View Mode list, select Album (other view modes would work as well as these volume controls are shared by several view modes), and then from the View Mode Controls list, you would uncheck the following Conrol IDs: IDC_BUTTON_VOL_DN, IDC_BUTTON_VOL_UP, and IDC_CUR_VOL_VAL.??12.7 Volume NormalizationVolume NormalizationFor Volume Normalization, I had implemented this at one point in TJs to do volume normalization on the fly, but even on a high end PC, the amount of processing time and disk access time made was so intense (almost a minute) that it was simply not doable because of the cross-fader and the lag before the next song was ready to play. So, I abandoned this effort, and did find that there was other software out there which was dedicated to volume normalization. The software which I used on my music collection was MP3 Gain ( HYPERLINK "" ) and it did a good job, albeit it took a long time to process all the songs.12.8 Sending Log Files to Tech SupportSending Log Files to Tech SupportTo help resolve bugs, TouchJams has the ability to create run-time log files.? If at some you would like to send a log file to Tech Support, here's the steps to follow:Turn on Verbose Logging - Options/System/Health - check Verbose LoggingRestart TouchJamsPerform the necessary steps to reproduce the bugExit TouchJamsNavigate to the folder where the log file resides - this will depend on the flavor of Windows you are running:??? XP : C:\Documents and Settings\(logged in user)\Application Data\TouchJams??? Vista/7/8 : C:\Users\(logged in user)\AppData\Roaming\TouchJams?Email the file CurrentApplicationLog.bin to HYPERLINK "mailto:support@?subject=TJs Log File" support@???12.9 TouchJams USB Dongle EditionTouchJams USB Dongle Edition - Coming Soon The TouchJams USB Dongle Edition offers an alternative approach to HYPERLINK "C:\\VC\\TouchJams\\WinCHM\\SingleHTML\\Activation.htm" \t "_blank"program activation and verification.? With this TouchJams edition, you?simply insert the USB Dongle into the machine?where the TouchJams Dongle Edition is installed, and you are ready to go.USB Dongle InstallationThe TouchJams USB dongle doesn't require any special drivers, and works with all flavors of Windows (XP through 8.x).? When the USB dongle is inserted for the first time, you should see the following behavior:Start?Finish?Jukebox IDs (JIDs)Each TouchJams dongle has an encoded jukebox identifier (JID).? This JID is a globally unique identifier and allows companies to track all their jukeboxes.? While TouchJams is running, you can view the JID by going to Options/Help.? If you would like to copy the JID to the Windows clipboard, simply click the JID.? ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download