TouchJams   

1. Introduction

Welcome to TouchJams HelpHot Topics

Program ActivationMusic Tag Info

Tutorial: Adding a New Language to TouchJamsTutorial: Custom   Display Text Within TouchJams

     

2. FAQ2.1 Program Activation/VerificationProgram Activation/VerificationAfter 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 Type Description1 - 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 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/VerificationTo 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 1Enter your Product Key.  Your Product Key should look something like TJSSTD-XXXX-XXXX-XX.

Step 2When 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/VerificationTo 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 1Enter your Product Key.  Your Product Key should look something like TJSSTD-XXXX-XXXX-XX.

Step 2When this window appears, simply hit the Cancel button and continue to the next step.

Step 3Within this window, select Manual Activation.

Step 4This 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: 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@touchjams.com, 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 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 XP C:\Documents and Settings\All Users\ACH\TJSSTD

Windows Vista/7/8 C:\ProgramData\ACH\TJSSTD

If 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\cm

The 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=NO

We 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=Once

Trial=NeitherNetworkClientAllowed=NoProductKey=TJSSTD-XXXX-XXXX-XX[Messages]ShowWebCheckMessage=NO

After adding this line, save the file and close it.Start TouchJams, and then exit TouchJams. ***  IMPORTANT ***At this point contact support@touchjams.com 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 InfoIn 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 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 SoftwareTag & Rename  product homepage KJ File Manager  product homepage

Jaikoz  product homepage MP3Tag  product homepage

SongKong  product homepage

 

2.2.2 Tag Info Text FileTag Info Text FileAnother 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=311 to download this file, click herealbum=Music

title=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 FAQs

2.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.ZIP

As 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 here and run the install.For customers who purchased TouchJams prior to v2.0:

Email support@touchjams.com 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 ErrorsAfter 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: Media Library RecommendationsSetting Tag Info

5. 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 Field Default ValueArtist "Unknown"Album "Unknown"Title filename less the folder and filename extension

Folder 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 Way Correct Way

Local Disk (C:)   My Music      Artist A - Best Of - Track X.mp3      Artist B - Best Of - Track X.mp3      ---      Artist X - Best Of - Track X.mp3

Local 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.mp3

In 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 appear

If 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 Administra

For 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 Settings in the General Options section, check the box "Hide Taskbar In Protected Mode"

8. User Group Control PropertiesUser Group Control Properties

TouchJams 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 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 downloadAdobe PDF download

 

10. Program OptionsProgram Options

 

10.1 LibraryLibrary

 

10.1.1 MusicMusic Library

 Statistics Total Artists Total artists in library. Total Albums Total albums in library. Total Albums Total titles in library.

 Sources

Add Select 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:  click here

Edit This will allow editing a library source.  After this is selected the following dialog will appear: click here

Delete Select 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 Startup

Check this box to have TouchJams automatically update the music library when it starts. Not recommended for large music libraries.

Enforce Minimum Tag

Info

Check 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.

ActionsFiles To Skip Files TouchJams should skip when updating the music library. Click here for additional

information.Tag Editor Launch the built-in tag editor.

Export Export the music database information to a delimited text file. Update Update the music library. Updating adds to, but does not reset the music library.

Results Select 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.

 Reset Select 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 Artists Total artists in library. Total Albums Total albums in library. Total Albums Total titles in library.

 Sources

Add Select 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:  click here

Edit This will allow editing a library source.  After this is selected the following dialog will appear: click here

Delete Select 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 Startup

Check this box to have TouchJams automatically update the music library when it starts. Not recommended for large music libraries.

Enforce Minimum Tag

Info

Check 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 Skip Files TouchJams should skip when updating the music library. Click here for additional information.

Tag Editor Launch the built-in tag editor.Export Export the music database information to a delimited text file. Update Update the music library. Updating adds to, but does not reset the music library.

Results Select 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.

 Reset Select 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 Artists Total artists in library. Total Albums Total albums in library. Total Albums Total titles in library.

 Sources

Add Select 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:  click here

Edit This will allow editing a library source.  After this is selected the following dialog will appear: click here

Delete Select 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 Startup

Check this box to have TouchJams automatically update the music library when it starts. Not recommended for large music libraries.

Enforce Minimum Tag

Info

Check 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 Skip Files TouchJams should skip when updating the music library. Click here for additional information.

Tag Editor Launch the built-in tag editor.

Export Export the music database information to a delimited text file. Update Update the music library. Updating adds to, but does not reset the music library.

Results Select 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.

 Reset Select 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 Library

StatisticsTotal

Stations Total stations in library.

LibraryFolder Drive/path where music files are located

ResetSelect 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.

Update Update 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 options

10.2 AppearanceAppearance

 

10.2.1 SkinsSkins

TouchJams has a fully skinnable interface.Select Apply the currently selected skin.Scale Scale an existing skin to a specific screen size.

Edit Skin Edit an existing skin.Refresh Select this option to refresh the appearance of TouchJams.

Download Download additional available skins.Folder Drive/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:Key Action Description

S Show Skin Control Properties

This will allow you to simply hover over a control with the mouse, hit "S", and the skin editor will popup with the control selected.

G Select 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

Folder Drive\path of the album art image cache filesReset Resets the album art cache and forces it to rebuild

Manage Manage album art filesAlbum Art Load Rules

Tag Info, Then Music File Location

Use tag info images if present before using images stored in the same path as the music file

Music File Location, Then Tag Info

Use images stored in the same path as the music file, if present, before using tag info images

Update Album ArtCopy Album Art to Music File

LocationSave Album Art to Music File

(MP3/WMA only)Default Album Art Filename Default name for album art images located in the same path as music

files.

10.2.2.1 Manage Album ArtTouchJams Manage Album Art

10.2.2.1.1 Album ItemsTouchJams Album Items

The 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 InformationGroup

The 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 Info To edit the tag info for the selected item, hit the Tag Info button.Album Art To 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 InformationGroup

The 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.

Apply This 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.

Import Selecting 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.

Enabled Check this box to display Advertisements while TouchJams is running.Folder Drive\path of the Advertisement images.

10.2.4 Screen SaverScreen Saver

Screen Saver SettingsEnable Internal Screen Saver

Video FilenameStart After:

Enable for Protected Mode OnlyKeep Aspect Ratio

Preview

10.2.5 Configure MonitorsConfigure Monitors

2nd Monitor ContentNothing

AdvertisementsConfigure

Now PlayingPrimary Monitor -

Karaoke/VideoShow Album Art

Show VideoSecondary Monitor -

Karaoke/VideoShow Album Art

Show Video

10.2.6 LanguageLanguage

TouchJams supports multiple languages, and ships with English - United States as the default language.  From the 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 Language Select the default language to use.Available Languages Check the languages which you want to be able to toggle through on the main

TouchJams window (this is not released yet ).Manage Select 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 OptionsLanguage ManagerAdd LanguageControl PropertiesKeyboard Mappings

10.2.6.1 Language ManagerLanguage Manager

From within the TouchJams Language Manager, you can add languages, delete languages, and import/export languages.

Add Click this to add a new language.  For help with the Add Language window, click here.Delete To delete the currently selected language, click this button.Import After 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.Export This will export ALL languages to file.

See Also: Language OptionsLanguage ManagerAdd LanguageControl PropertiesKeyboard Mappings

  10.2.6.1.1 Import Languages

10.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 Language Specify the new language that you want to define.Template Language Specify the language you want to use as the template.

See Also: Language OptionsLanguage ManagerAdd LanguageControl PropertiesKeyboard Mappings

10.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 this .

Control TextDefault The default text for the control.Custom Custom text to appear within TouchJams.

View Skin Properties Select this to launch the Skin Editor with this control selected.Note To specify a line break within the text, enter "(nl)" where the line break is to

occur.

See Also: Language OptionsLanguage ManagerAdd LanguageControl PropertiesKeyboard Mappings

 10.2.6.4 Tutorial - Add a New Language

Tutorial: Add a New Language to TouchJamsAdd a New Language

Step 1 From 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 3 You should see a window indicating that the language creation was successful.Step 4 Close out all windows so that you are back to the TouchJams main screen.

Control PropertiesA 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 5 From 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 7 Close out all windows so that you are back to the TouchJams main screen.

Language Translation

Step 8

From 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 TranslationStep 9 From the main TouchJams screen, select Options / Appearance / Language / Manage.

Step 10 Select the Export button, specify the filename to export the language data to.  After this file is created, simply email this file to support@touchjams.com.

See Also: Language OptionsLanguage ManagerAdd LanguageControl PropertiesKeyboard Mappings

     10.2.6.5 Tutorial - Custom Display Text

Tutorial: Custom Display Text within TouchJamsControl PropertiesA 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 1 From 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 3 Close out all windows so that you are back to the TouchJams main screen.Change the Text

Step 4

From 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: Language OptionsLanguage ManagerAdd LanguageControl PropertiesKeyboard Mappings

     

 

10.3 View Settings 

10.3.1 GeneralView Settings

Below are the TouchJams general view settings:General Options

Main Window Can Move Check this option to allow users to move the TouchJams main window. Uncheck this option to lock the main window.

Show Taskbar Icon Check this option to show the Taskbar Icon.Scrollbars – Use Page Buttons Check this option to use Page Buttons on the Scrollbars. Using page

buttons is recommended for large music libraries.Show Mouse Cursor Check this option to hide the mouse cursor in TouchJams.

Hide Taskbar In Protected Mode Checking 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 OptionsSearch Exact Phrase

Search All Years Check this option to allow the search to include all years.Search All Genre Check this option to allow the search to include all Genres.

Custom Search Letters Include certain custom letters.

10.3.3 Charts ViewCharts View

Below are the TouchJams Charts View settings.Top Played View

Popular Items This number determines how many items are displayed in the Popular Items View.

History Items This 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

Days This number determines how many days an added song is considered to be “new”.Items This number determines how many newly added items appear in the new songs

view.

10.3.5 Genre View

10.4 SoundSound

 

10.4.1 VolumeVolume

Volume configuration settings.Volume Control

Internal Player Adjust this slider to set the internal player volume of TouchJams.Internet Radio Adjust this slider to set the internal player volume of the Internet Radios Stations.

Sound Card Mixer

Master Volume This sets the master volume of the installed sound card mixer.

Wave Volume Adjust this to set the wave volume of the installed sound card mixer. Note: this does not apply to Windows Vista or 7

MiscellaneousVolume Step This 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 VolumeEnabled Check 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 Defaults

Volume Defaults

 

10.4.2 EQEQ

TouchJams comes with a built in 10-band equalizer.

Preset Select 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.

Enabled Check this box to enable the equalizer.Flat Select this to set each EQ band to 0.

10.4.3 Auto DJAuto DJ

Auto-DJ configuration settings.Genre Filter Enabled Check this to filter songs by selected genre.

Genre Groups (screen-shot)Select All Check all genre list items.Clear All Uncheck all genre list items.

Year Filter Enabled Check this to filter songs by selected year/decade.Select All Check all year/decade items.Clear All Uncheck all year/decade items.Auto-DJ Disabled Select this option to disable Auto-DJ

JukeBox Select this option to enable the Jukebox Auto-DJ

RadioSelect this option to enable the Radio Auto-DJ. (with this option selected you may chose “random” radio stations or select specific stations.

Build Auto-DJ Select 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.

Enabled Select this option enable the Cross FaderSet Default

Values Select this option to reset all values to their default values

Fade Out Enabled Select this option to enable Fade Out

Fade In Enabled Select this option to enable Fade In

Fade Out Type The 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 SystemSystem

10.5.1 AdminAdministrator Options

Startup Settings/Administrator Logout

UserView

User ManagerClick this button to manage users and user groups.Click here for additional help.

10.5.1.1 User Manager

10.5.1.1.1 Add User

10.5.1.1.2 Edit User

10.5.1.1.3 User Group Manager

10.5.1.1.3.1 Add User Group

 10.5.1.1.3.2 Edit User Group

10.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 Enabled Check this to enable the Genre Filter.

Genre Groups (screen-shot)Select All Selects all genre.Clear All Deselects all genre.

Year Filter Enabled Check this to enable the Year Filter.Select All Selects all year decades.Clear All Deselects 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.

Add Add a keystroke mapping.Edit Edit an existing keystroke mapping.

Delete Delete 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 AvailablePhysical Percentage of physical memory being used.Page File Percentage of Windows Page File being used.

Virtual Percentage of the Windows Virtual Memory being used.

Load The 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 LoggingVerbose Logging Check 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@touchjams.com.

10.5.5 Remote ControlIR-Remote

TouchJams has built-in support for the USB-UIRT IR Remote hardware/software sold through the website http://www.usbuirt.com  This hardware will allow virtually any IR-Remote to be used with TouchJams.

USB-UIRT IR RemoteDriver Version If 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 here.

Command CodesAdd Add a new remote code function.Edit Edit an already existing remote code function.

Delete Delete an already existing remote code function.

10.5.6 Import MusicImport Music

Manually Import MusicFolder Drive\path to export music database file.Import

Automatic Import MusicAutomatically Detect and

Import USB MediaPrompt Before Importing

Ignore Drives Larger ThanMusic Folder/Filename

ConventionType (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 MusicFolder Drive\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 Every Frequency 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 ActionsShow Now Playing For The amount of time to display the Now Playing view.

Show Song Spotlight For The amount of time to display the Song Spotlight view.  This view randomly displays songs which have already been played.

Show Advertisements For Length of time to display advertisements.  For help with setting up advertisements, click here.

Start Auto DJ After Length of time to expire before starting Auto DJ mode.  For help with setting up Auto DJ, click here.

MiscUpdate Player Position

EveryShow 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 Enabled Check this option to enable the web server.  After selecting this

option, Windows may raise a security alert - see Windows Firewall below.

Port Number This is the port number which TouchJams will communicate over.Connection This 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 ConfigurationTo configure your laptop, PC, or cell phone to access the TouchJams web server, please see Configure Web Server Client.

Windows FirewallWhen 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 OperationRandom Insert Check this option to randomly insert selected songs into the play

queue.Append To End Check this option to add selected songs to the end of the play queue.

Same Song Play DetectionEnabled Select this option to limit how many times a particular song can be

played in the selected time period.Limit Play to X Times

Every Y HoursUse these two settings to set how often a song can be added to the queue.

10.5.11 Scheduled EventsScheduled Events

10.5.11.1 Day TimeScheduled Item - Day/Time

10.5.11.2 Auto DJScheduled Item - Auto DJ

10.5.11.3 PlaylistScheduled Item - Playlist

 10.5.11.4 SkinSkin

10.5.11.5 Screen SaverScheduled Item - Screen Saver

10.5.11.6 MiscScheduled Item - Misc

10.5.12 Custom Command

10.5.13 BetaBriteBetaBrite

Add: This will let you add a action.  Please see here. 

 10.5.13.1 Edit ActionBetaBrite Action

Event TypeNothing Playing Nothing is playing in the TouchJams.

Song Playing A song is currently playing.Song Start A song has just started to play.

Song Enqueued A song has just been added to the Jukebox PlaylistAdvertisement An advertisement is currently being displayed.Music Chart A music chart item is currently being displayed.

Command: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 

Description Tag

Colors {RED} {GREEN} {AMBER} {BROWN} {ORANGE} {YELLOW} {RAINBOW} {MIXED} {AUTO}

Date & Time {TIME} {DATE}

   

10.5.14 Video OptionsVideo Options

10.6 Revenue

10.6.1 Coins-Bills

If 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 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@touchjams.com

10.6.2 Reports

10.6.2.1 Counters Report

10.6.2.2 Revenue Report

10.6.3 Revenue Options

11. About TouchJams

About 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.Add Add a file to the list.

Remove Remove the selected file from the list.Help Displays this help topic.Close Closes the Skip File List window.

12.2 Catch File CrashUpdate Library ErrorWhen 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 here.

12.3 Library SourceLibrary Source

12.4 Update Library ResultsUpdate Library Results

CloseTag InfoExplorer

HelpView All

Error Code Error Description0 no error - file was successfully added to the TouchJams Library1 item already exists2 out of Memory

3 invalid database ID4 tag info load error5 missing tag info6 invalid karaoke filename

12.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 (http://mp3gain.sourceforge.net/) 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:

1. Turn on Verbose Logging - Options/System/Health - check Verbose Logging

2. Restart TouchJams3. Perform the necessary steps to reproduce the bug4. Exit TouchJams5. Navigate 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 

6. Email the file CurrentApplicationLog.bin to support@touchjams.com   

12.9 TouchJams USB Dongle EditionTouchJams USB Dongle Edition - Coming Soon

The TouchJams USB Dongle Edition offers an alternative approach to 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.