Often times when using kJams Server, the user will miss the "Song Added" alert at the bottom of the window. (Heck, even I just recently noticed it!) As a result, they will mistakenly hit the "Tonight" button over and over, thus adding the song multiple times. To combat this (but not be quite as intrusive as a pop up alert) I made this little code snippet that will make the text bright red and flash it several times to catch the users attention.

To use it, open the file "main.js" (it should be in "~/Libraries/Preferences/kJams/server") and find the "function m_setStatus(status, revert)" code block. Replace it with the text below and save.

<pre>
function m_setStatus(status, revert) {
statusObj = document.getElementById("status");
statusObj.innerHTML = "<span style='color:#FF0000'>" + status + "</span>";
var newInnerHTML='statusObj.innerHTML = "<span style="color:#FF0000">" + status + "</span>"';
blink();
setTimeout("statusObj.innerHTML = newInnerHTML",1250);
}

function blink(){
blinkFlag = 1
blinkCount = 1
blinkTimer();
}

function blinkTimer(){
if(blinkFlag==1){
blinkSpeed=250
blinkNumber=10 //If this value is even, the text flashes then remains visible. If it is odd, it flashes, then disappears
blinkFlag=0;
blinkCount++;
document.getElementById("status").style.visibility='visible';
}else {
blinkFlag=1;
blinkCount++;
document.getElementById("status").style.visibility='hidden';
}
if (blinkCount < blinkNumber) {setTimeout('blinkTimer()', blinkSpeed);}
}

</pre>

In addition, it is very useful to trap the delete key, so that users do not inadvertently go back to the previous page by hitting this key (which, for instance, might take them back to the previous singers page from the login screen after a log out). This would be bad!
To do this, you need to make a few mods to the pages. In particular, you need to call the function in your pages. To make it work, paste this into the variable declaration section of your main.js (at the top).

<pre>
//checks to see if the search field it in focus. If it is, allow the user to use the Delete/Backspace key. Otherwise, set flag to trap it.
var inSearch = {
on: function() {allowBackspace = true;},
off: function() {allowBackspace = false;}
}
</pre>

And then add this somewhere in the function declarations:

<pre>
function trapDelete() {
//Checks to see if the key pressed is the Delete/Backspace key, and if so, stop it from getting to the browser.
var keyID = (window.event) ? event.keyCode : e.keyCode;
if (keyID==8 && !allowBackspace){
return false;
}
return true;
}
</pre>

Then you can just add the following code into the javascript section of your other pages:
<pre>
//Bind key press function
document.onkeyup = m_keyPressed;
//Prevent browser from seeing the Delete key press
document.onkeydown=trapDelete;
</pre>

Alternately, you can just use the entire main.js file from the previous page.

Lastly, it is probably undesirable in a kiosk-type session to allow the person to close the window on your laptops, thus making the machine useless for the next user. To block this, I added the following code:

Add this to the script section of your mainscreen.html file (and any other page you want to stop the user from closing:

<pre>
//function triggered by any closing of the current document
function confirmUnload(){
if(!allowUnload){
//message displayed (as well as inbuilt IE junk) when page is unloaded.
return 'Why on earth would you think it is a good idea to close this window?!? Well, it ISN\'T!!! Do NOT close this window. If you do, all hell will rain down upon you, you will cause a micro-singularity to destroy the known universe, and I will get very upset. (At you closing the window, not the destruction of the universe, that can fend for itself.)\n :\'(';
}
}
</pre>

Then add the following lines to the function m_sessionLogout function of your main.js

<pre>
// Sets the flag to tell confirmUnload subroutine that it is OK to let the user leave this page (close the Window, etc.)
allowUnload = true;
</pre>

If you want to force users to use both first and last names (useful if you use server heavily, since otherwise you will very quickly have name conflicts, at least in your history, if not in your tonights) you can use the following modified newsinger.html code. In addition, the new code puts instructions in the various fields, in particular that password field (since some people seem to have a hard time figuring out that what they have to do). For those interested, it was necessary to use a bit of a hack here. Normally the password field is encoded, so that when you type in characters, they get represented as "•" bullets (to prevent people from seeing the password being entered). But one consequence of this is that any text you put in the field to prompt users gets changed to bullets too.
So the code I added tricks the browser engine into thinking, just for a moment as it is being drawn, that it is NOT a password field (by actually making it a normal text field, and then, after the guide text is placed, changing it back to a password field, out from under the browser.

<pre>
<html>
<head>
<meta http-equiv=Content-Type content="text/html; charset=UTF-8">
<title>kJams New Singer</title>

<script src="common.js"></script>
<script src="./spry/xpath.js"></script>
<script src="./spry/SpryData.js"></script>
<script src="data.js"></script>
<script type="text/javascript">
function catname(){
var firstname = document.forms[0].singerfirstname.value;
var lastname = document.forms[0].singerlastname.value;
document.forms[0].singername.value = firstname + " " + lastname;
}
function validate(thisform) {
with (thisform){
if (singerfirstname.value=='') {
alert('Hey, unless you\’re Obama, ya gotta give me a first name too. Try again.');
event.returnValue=false;
}
else if (singerlastname.value=='Required!') {
alert('What, you think you\’re Madonna? A last name is required. Lets try this again..');
event.returnValue=false;
}
//safe to navigate away from this page
}
}
//variable to control if message is shown
var allowUnload = false;

//function triggered by any closing of the current document
function confirmUnload(){
if(!allowUnload){
//message displayed (as well as inbuilt IE junk) when page is unloaded.
return 'Why on earth would you think it is a good idea to close this window?!? Well, it ISN\'T!!! Do NOT close this window. If you do, all hell will rain down upon you, you will get A.I.D.S., and I will get very upset. (At you closing the window, not the A.I.D.S..)\n:\'(';
}
}

//register function with the event handler
window.onbeforeunload = confirmUnload;
</script>

<style type="text/css">
#main {
width: 400px;
margin-left: auto;
margin-right: auto;
text-align: center;
background: url('metal.jpg');
border-style: solid;
border-color: #000000;
border-width: 1px;
}

#main p {
font-size: 24pt;
}

#main table {
margin-left: auto;
margin-right: auto;
}

#main img {
margin-bottom: 10px;
}
</style>
</head>

<body>
<div id="main">
<p>New Singer</p>
<img src="kjams.png" /><br />
<font color="#FF0000"></font>
<form id="form" method="POST" action="" onsubmit="validate(this); allowUnload=true">
<table>
<input type="hidden" id="singername" name="singername">
<tr><td>First Name: </td><td><input type="text" name="singerfirstname" value="" onkeyup="catname()"/></td></tr>
<tr><td>Last Name: </td><td><input type="text" name="singerlastname" value="Required!" onfocus="this.value= (this.value=='Required!') ? '' : this.value" onBlur="this.value= (this.value=='') ? 'Required!' : this.value" onkeyup="catname()"/></td></tr>
<tr><td>Password: </td><td><input type="password" name="password" id="password" /></td></tr>
<script type="text/javascript">
var p = document.getElementById('password');
p.type = 'text';
p.value = 'Make a password';
p.onfocus = function() {
if (this.type == 'text') {
this.value = '';
this.type = 'password';
this.focus();
}
}
</script>
<tr><td>Again: </td><td><input type="password" name="confirm" value="" /></td></tr>
<tr><th colspan="2"><input type="submit" name="submit" value="Jam Out!" /></th></tr>
</table>
</form>
<p style="font-size: 12pt;">[ <a href="/" onClick="allowUnload=true">Back</a> ]</p>
</div>

<script language="javascript">
document.getElementById("form").action = url_newsinger;
</script>
</body>
</html>
</pre>

Another recurring issue is that many people don't seem to understand the entire paradigm, and insist on adding themselves as a new singer every time they want to add a new song. To help prevent that, I added an extra confirmation step to try to get across the fact that this is not helpful. Try the modified login screen code below:
<pre>
<html>
<head>
<title>kJams Login</title>

<script src="common.js"></script>
<script src="./spry/xpath.js"></script>
<script src="./spry/SpryData.js"></script>
<script src="data.js"></script>

<script type="text/javascript">
function iPhoneAlert() {

if ((navigator.userAgent.match(/iPhone/i)) || (navigator.userAgent.match(/iPod/i))) {
var question = confirm("You need iJams to log in!")

if (question) {
window.location = "http://itunes.apple.com/WebObjects/MZStore.woa/wa/viewSoftware?id=301301004&mt=8";
}
}
}

//variable to control if message is shown
var allowUnload = false;

//function triggered by any closing of the current document
function confirmUnload(){
if(!allowUnload){
//message displayed (as well as inbuilt IE junk) when page is unloaded.
return 'Why on earth would you think it is a good idea to close this window?!? Well, it ISN\'T!!! Do NOT close this window. If you do, all hell will rain down upon you, you will get A.I.D.S., and I will get very upset. (At you closing the window, not the A.I.D.S..)\n :\'(';
}
}

//register function with the event handler
window.onbeforeunload = confirmUnload;
</script>

<style type="text/css">
#main {
width: 400px;
margin-left: auto;
margin-right: auto;
text-align: center;
background: url('metal.jpg');
border-style: solid;
border-color: #000000;
border-width: 1px;
}

#main p {
font-size: 24pt;
}

#main table {
margin-left: auto;
margin-right: auto;
}

#main img {
margin-bottom: 10px;
}
</style>
</head>

<body onLoad="iPhoneAlert();">
<div id="main">
<p>Singer Login</p>
<img src="kjams.png" />
<form id="form" method="POST" action="" onSubmit="allowUnload=true">
<table>
<tr><td>Singer: </td><td id="singers">Please wait...</td></tr>
<tr><td>Password: </td><td><input type="password" name="password"></td></tr>
<tr><th colspan="2"><input type="submit" name="submit" value="Login" /> <input type="button" onClick="goNewSinger(); allowUnload=true;" value="New Singer" /></th></tr>
</table>
</form>
<div>[ <a id="helplink" onClick="allowUnload=true" href="">Help</a> ]</div><br />
</div>

<script language="javascript">
document.getElementById("form").action = url_main;
document.getElementById("helplink").href = url_help;

getSingers(url_singers, populateSingers);
function populateSingers(singers) {
var selectObj = document.createElement("SELECT");
var optgroupObj = document.createElement("OPTGROUP");

selectObj.name = "singer";
selectObj.style.width = "100%";

optgroupObj.label = "";

for (var i = 0; i < singers.length; i++) {
if (singers[i]['name'][0].toUpperCase() != optgroupObj.label) {
optgroupObj = document.createElement("OPTGROUP");
optgroupObj.label = singers[i]['name'][0].toUpperCase();

selectObj.appendChild(optgroupObj);
}

var optionObj = document.createElement("OPTION");
optionObj.value = singers[i]['id'];
optionObj.innerHTML = singers[i]['name'];
optgroupObj.appendChild(optionObj);
}

document.getElementById("singers").innerHTML = "";
document.getElementById("singers").appendChild(selectObj);
}

function goNewSinger(){

var newSingerConfirm=prompt("HEY YOU.\n\nREAD THIS DIALOGUE BOX ALL THE WAY THROUGH!!!:\n\nOnly add yourself if you have never, EVER sung with me before. If you have EVER sung with me before, even if it was a two years ago, even if your name is not in the list, but you think it should be, PLEASE do not add yourself again. Instead, come see me to add your name to the system. If you really ARE a new singer, however, type in the value of equation","2+3=?");
if (newSingerConfirm == "5")
{
window.location=url_newsinger;
}
else
{
window.location=url_loginscreen;
}
}

</script>
</body>
</html>

Feel free to modify the confirmation text as you see fit.
</pre>

Code/new Copy Singers

2012-09-06T19:59:21Z

Deusexmachina:

So with the advent of "Venues" you may have run into the situation where a singer from another venue shows up out of the blue at the current venue, wanting to see their history list. Accessing it is kinda a nightmare, involving going to the Finder, drilling down until you find the right singer folder, creating an alias, and then copying that alias over to the current venue folder, followed by changing venues in kJams, and then changing it back again in order to force kJams to reload the current venue's Singers folder.

Well, I can't do anything about the kJams end of things, as that functionality is not currently exposed to an API like Applescript, but what I can do is automate the rest.
After a full 1/2 day of work (mostly since I am a lousy programmer!) I managed to get the following working. You have two choices on how to use this. You can open Applescript Editor and paste the following code into a new script window, and save as an application, and then run as you would any other application.
But better yet, open up Automator, select "Service" from the template choices on the opening splash screen, and then drag "Run AppleScript" from the Library onto the Stage. Change the "Service receives selected" popup to "no input", and "applications" to "kJams". (First choose "other…" from the popup menu, and then browse to kJams in the file selector.) Next, paste the following code over top of where is says "(* Your script goes here *)", change the first line where it says "set kJamsPath to "Users/yourusername/Music/kJams/kJams Library/" by replacing "yourusername" with, oddly, you user name (use your short user name) and save.

Then when you run kJams, and need this functionality, either run the application from where you saved it to, or if you saved it in automator as a service, simply select "Services" from the kJams menu, and then select your saved service.
At that point just follow the prompts to tell the service which singers you want to transfer (you can transfer multiple singers at the same time.) This will put an alias in your current venue folder, thus letting that singer access his or her playlists from either venue.

If this is helpful, let me know [https://karaoke.kjams.com/forum/viewtopic.php?f=1&t=1406&sid=844b30850395dd5448ac2bf9a78a581c&p=7915#p7915 here].

UPDATE:
Thanks to recent additions to the kJams code and its exposure to AppleScript, I was able to fully automate the code. Use the following code now to perform the entire act of copying the singers' folders to the new venue AND actually making kJams recognize that the singers are in the new venue.
Proceed with a small amount of caution, however, as you are on the cutting edge here, and you might get a little blood on you! In particular, it appears to expose a bug that causes kJams to go slightly bonkers, and possibly lose the copied singers' lists IF you already have an alias to the same singer(s) in that venue already. I am speculating that this is because you are trying to have multiple singers with the same ID, and kjams gets noticeably, and justifiably, upset. This should affect almost no one, and actually no one, if you don't mess around in your venues by hand and run this script hundreds of times, thus getting things royally confused in there, trying to test things out!
As always, let me know how it is working!

P.S. as added goodness, in my testing, the new code NEVER caused server to fail to come back up due to an unreleased port!
P.P.S. If you totally love this, please feel free to [https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=manifold_sky%yahoo%2ecom&item_name=kJams%20Video%20Backdrop%20Donation&no_shipping=2&no_note=1&currency_code=USD&lc=US&bn=PP%2dBuyNowBF&charset=UTF%2d8 paypal the author].

<iimg>https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=manifold_sky%yahoo%2ecom&item_name=kJams%20Video%20Backdrop%20Donation&no_shipping=2&no_note=1&currency_code=USD&lc=US&bn=PP%2dBuyNowBF&charset=UTF%2d8
!http://kjams.com/resources/paypal.gif</iimg>

<pre>
on run {input, parameters}

set kJamsPath to "Users/yourusername/Music/kJams/kJams Library/" -- You need to edit this line to the path to YOUR kJams Library folder
set kJamsLibraryPath to kJamsPath & "Library.xml"
set XMLfile to (POSIX file (kJamsLibraryPath))
set Paras to paragraphs of (read XMLfile)
-- we cycle through the list and extract the portion between the tag we're interested in
-- we know that the tag we want is immediately after "<key>Current Value</key>"
set tagValue to {}
repeat with i from 1 to count of Paras
if item i of Paras contains "Current Venue" then -- first we find the tag we're interested in
set tagValue to item (i + 1) of Paras
exit repeat
end if
end repeat
-- return tagValue
-- next we extract each value from the found tags knowing that the value is between "<string>" and "</string>
repeat with i from 1 to count of tagValue
set thisTag to item i of tagValue
set thisTagValue to ""
if thisTag is ">" then
repeat with k from (i + 1) to count of tagValue
set thisTag to item k of tagValue
if thisTag is "<" then exit repeat
set thisTagValue to thisTagValue & thisTag
end repeat
exit repeat
end if
end repeat
thisTagValue
set kJamsPath to kJamsPath & "Venues/"
set venuePath to (POSIX file (kJamsPath))
set singerPath to (POSIX file (kJamsPath & thisTagValue & "/Singers"))
set Singers to (choose folder default location alias venuePath with prompt "Choose singers to copy to the current venue" with multiple selections allowed) as list
repeat with i from 1 to count of Singers
tell application "Finder"
set Singer to item i of Singers
make new alias file at singerPath to Singer
end tell
end repeat
set kScriptCommand_RESCAN_VENUE to 19
tell application "kJams Pro"
docommand kScriptCommand_RESCAN_VENUE
end tell
return input
end run
</pre>

Server/Code/modifications to main.js

2012-09-04T06:10:43Z

Deusexmachina:

Code/new kJams server pages with autologout

2012-09-04T03:50:41Z

Deusexmachina: /* = */

Since the official autologout was removed, I have re-edited my mainscreen.html page to re-implement it. In addition, this versin traps the delete key, so instead of doing the rather annoying web standard "back a page" when the user hits the delete key, it does the MUCH more intuitive "remove the currently selected song from the active playlist." There may be some other tweaks, but those are the highlights. Simply replace the server files with these:

(As always, I hope someone finds this helpful, and consider sending me a P.M. letting me know what you think)

main.js:
<pre>
/* kJams Project - main.js
Description: Main screen functionality.
(c) 2007 kJams and David M. Cotter */

var timer = null;
var lastPing = 0;
var allowBackspace = false;
//checks to see if the search field it in focus. If it is, allow the user to use the Delete/Backspace key. Otherwise, set flag to trap it.
var inSearch = {
on: function() {allowBackspace = true;},
off: function() {allowBackspace = false;}
}

function m_populatePlaylists() {
//Remove anything that was already there
divObj = document.getElementById("playlists");

for (var i = 0; i < divObj.childNodes.length; i++) {
divObj.removeChild(divObj.childNodes[i]);
}

list = new KJDropList();
list.create(divObj);
playlistsList = list;

getPlaylists(url_playlists, m_playlistsLoaded);
}

function m_playlistsLoaded(list) {
listCtrl = document.getElementById("playlists").childNodes[0].parent;

for (var i = 0; i < list.length; i++) {
if ((list[i]['name'] == "Library") || (list[i]['name'] == "History"))
dropTarget = false;
else
dropTarget = true;

listCtrl.addItem("p" + list[i]['id'], list[i]['name'], dropTarget, null, false);

//Library and History items are not rearrangeable
if ((list[i]['name'] == "Library") || (list[i]['name'] == "History"))
document.getElementById("p" + list[i]['id']).rearrange = false;
else
document.getElementById("p" + list[i]['id']).rearrange = true;

//Keep track of ids for 'Tonight' and 'Favorites'
if (list[i]['name'] == "Tonight") {
pTonightID = list[i]['id'];
}

if (list[i]['name'] == "Favorites") {
pFavoritesID = list[i]['id'];
}

//Store the playlist name in the DOM object
document.getElementById("p" + list[i]['id']).name = list[i]['name'];
}

listCtrl.color();
listCtrl.evtClick = m_populateSongs;
listCtrl.evtDropInto = m_playlistDrop;
}

function m_populateSongs(playlist) {
playlist = playlist.substring(1);

//Hide
if (songsList) {
songsList.hide();

if (songsList.playlist != "1") {
songsList.destroy();
}
}

//Hide "No Playlist" message, show waiting message
document.getElementById("message").style.display = 'none';
document.getElementById("msg_dosearch").style.display = 'none';
document.getElementById("msg_error").style.display = 'none';
document.getElementById("waiting").style.display = '';

//If the list is already loaded, simply display it
if ((playlist == "1") && (songsLists[playlist] != undefined)) {
songsList = songsLists[playlist];
songsList.show();
document.getElementById("waiting").style.display = 'none';
}

//If it's the library, request that user do a search first
else if (playlist == "1") {
document.getElementById("waiting").style.display = 'none';
document.getElementById("msg_dosearch").style.display = '';
}

else {
//Playlist DOM object
playlistObj = document.getElementById("p" + playlist);

//Which columns are needed?
var columns = Array("#", "Song Name", "Artist", "Album");

if (playlistObj.name == "Tonight") {
columns.push("Pitch");
columns.push("Add to");
}

else if (playlistObj.name == "Favorites") {
columns.push("Add to");
}

else {
columns.push("Add to");
columns.push("Add to");
}

songsList = new KJList();
songsList.rearrange = playlistObj.rearrange;
songsList.playlist = playlist;
songsList.playlistName = playlistObj.name;
songsList.create(document.getElementById("songs"));
songsList.setColumns(columns, 0);
songsList.evtDrop = m_songRearrange;
songsLists[playlist] = songsList;
getSongs(url_songs, m_songsLoaded, "playlist=" + playlist);

if (false) {
songsList.evtColClick = null;
}
else {
songsList.evtColClick = m_sortSongs;
}
}

m_sessionCheckin();
}

function m_songsLoaded(list) {
//Hide waiting message
document.getElementById("waiting").style.display = 'none';

//Rearrangeable?
if (songsList.rearrange)
var rearrange = true;
else
var rearrange = false;

for (var i = 0; i < list.length; i++) {
//Add to favorites
var favsButton = document.createElement("INPUT");
favsButton.type = "button"
favsButton.name = songsList.playlist + "-" + list[i]['itemId'];
favsButton.songId = list[i]['id'];
favsButton.value = "Favorites";
favsButton.onmousedown = m_addToFavorites;

//Add to Tonight
var tonightButton = document.createElement("INPUT");
tonightButton.type = "button";
tonightButton.name = songsList.playlist + "-" + list[i]['itemId'];
tonightButton.songId = list[i]['id'];
tonightButton.value = "Tonight";
tonightButton.onmousedown = m_addToTonight;

//Columns
var columns = Array(i, list[i]['name'], list[i]['artist']);

if (typeof(list[i]['album']) == "object") {
var dropDown = document.createElement("SELECT");
dropDown.name = list[i]['id'];

for (var j = 0; j < list[i]['album']['items'].length; j++) {
var optionObj = document.createElement("OPTION");
optionObj.value = list[i]['album']['items'][j];
optionObj.innerHTML = optionObj.value;

if (list[i]['album']['default'] == j) {
optionObj.selected = true;
}

dropDown.appendChild(optionObj);
}

columns.push(dropDown);
}

else {
columns.push(list[i]['album']);
}

if (songsList.playlistName == "Tonight") {
//Drop-down
var options = {"+6" : 6, "+5" : 5, "+4" : 4, "+3" : 3, "+2" : 2, "+1" : 1, "0" : 0, "-1" : -1, "-2" : -2, "-3" : -3, "-4" : -4, "-5" : -5, "-6" : -6}
var dropDown = document.createElement("SELECT");
dropDown.name = list[i]['itemId'];
dropDown.songId = list[i]['id'];
dropDown.onchange = m_changePitch;
for (option in options) {
var optionObj = document.createElement("OPTION");
optionObj.value = options[option];
optionObj.innerHTML = option;

if(list[i]['pitch'] == options[option]) {
optionObj.selected = true;
}

dropDown.appendChild(optionObj);
}

columns.push(dropDown);
columns.push(favsButton);
}

else if (songsList.playlistName == "Favorites") {
columns.push(tonightButton);
}

else {
columns.push(tonightButton);
columns.push(favsButton);
}

index = songsList.addItem(songsList.playlist + "-" + list[i]['itemId'], columns, rearrange, null, false);

document.getElementById(songsList.getByIndex(index)).songName = list[i]['name'];
document.getElementById(songsList.getByIndex(index)).songId = list[i]['id'];
document.getElementById(songsList.getByIndex(index)).piIx = list[i]['itemId'];
}

songsList.color();

if (songsList.playlistName != "Tonight" && songsList.playlistName != "History") {
songsList.evtColClick = m_sortSongs;
}
else {
songsList.evtColClick = null;
}
}

function m_songRearrange(list, song, index, oldIndex) {
sendData(url_rearrange, "playlist=" + list.playlist + "&index=" + index + "&oldIndex=" + oldIndex);
m_sessionCheckin();
}

function m_playlistDrop(song, index, nodeId) {
playlists = document.getElementById("playlists").childNodes[0].parent;
item = songsList.getByID(song);

if (songsLists[playlists.getByIndex(index).substring(1)]) { songsLists[playlists.getByIndex(index).substring(1)].destroy(); }
songsLists[playlists.getByIndex(index).substring(1)] = null;
sendData(url_drop, "playlist=" + playlists.getByIndex(index).substring(1) + "&song=" + songsList.getByID(song).songId);

m_setStatus("Added \"" + item.songName + "\" to \"" + m_getPlaylistName(playlists.getByIndex(index)) + "\" ...");
m_sessionCheckin();
}

function m_addToTonight(event) {
playlists = document.getElementById("playlists").childNodes[0].parent;
m_playlistDrop(event.target.name, playlists.getIndex("p" + pTonightID), event.target.name);
}

function m_addToFavorites(event) {
playlists = document.getElementById("playlists").childNodes[0].parent
m_playlistDrop(event.target.name, playlists.getIndex("p" + pFavoritesID), event.target.name);
}

function m_sortSongs(list, column) {
list.removeAll();
list.setPrimaryCol(column);
document.getElementById("waiting").style.display = '';

if (document.getElementById("searchfield").value) {
search = "&search=" + document.getElementById("searchfield").value;
}

getSongs(url_sort, m_songsLoaded, "playlist=" + list.playlist + "&orderby=" + column + search);
m_sessionCheckin();
}

function m_changePitch(event) {
sendData(url_pitch, "song=" + event.target.songId + "&pitch=" + event.target.value);
m_sessionCheckin();
}

function m_doSearch() {
//Select "Library" in the side bar
playlistsList.select(playlistsList.getByID(playlistsList.getByIndex(0)));

//Remove old search list if it's there
if (songsLists["1"]) {
songsLists["1"].parentObj.removeChild(songsLists["1"].container);
songsLists["1"].parentObj.removeChild(songsLists["1"].columnsObj);
}

//Hide currently loaded list
if (songsList) {
songsList.hide();
}

document.getElementById("msg_dosearch").style.display = 'none';
document.getElementById("message").style.display = 'none';
document.getElementById("msg_error").style.display = 'none';
document.getElementById("waiting").style.display = '';

var columns = Array("#", "Song Name", "Artist", "Album", "Add to", "Add to");

songsList = new KJList();
songsList.rearrange = false;
songsList.playlist = "1";
songsList.playlistName = "Library";
songsList.create(document.getElementById("songs"));
songsList.setColumns(columns, 1);
songsLists["1"] = songsList;

getSongs(url_search, m_songsLoaded, "search=" + document.getElementById("searchfield").value);
m_sessionCheckin();
}

function searchKeyPressed(event) {
if (event.keyCode == 13) {
m_doSearch();
}
}

function m_getSongName(id) {
songObj = document.getElementById(id);
return songObj.songName;
}

function m_getPlaylistName(id) {
playlistObj = document.getElementById(id);
return playlistObj.name;
}

function kj_data_error(id, desc) {
songsLists[songsList.id] = null;
songsList.hide();
document.getElementById("waiting").style.display = 'none';

document.getElementById("msg_error").innerHTML = "Error: " + desc
document.getElementById("msg_error").style.display = '';
}

function m_setStatus(status, revert) {
statusObj = document.getElementById("status");
statusObj.innerHTML = "<span style='color:#FF0000'>" + status + "</span>";
var newInnerHTML='statusObj.innerHTML = "<span style="color:#FF0000">" + status + "</span>"';
blink();
setTimeout("statusObj.innerHTML = newInnerHTML",1250);
}

function blink(){
blinkFlag = 1
blinkCount = 1
blinkTimer();
}

function blinkTimer(){
if(blinkFlag==1){
blinkSpeed=250
blinkNumber=10 // If this value is even, the text flashes then remains visible. If it is odd, it flashes, then disappears
blinkCount++;
document.getElementById("status").style.visibility='visible';
}else {
blinkCount++;
document.getElementById("status").style.visibility='hidden';
}
blinkFlag^=1;
if (blinkCount < blinkNumber) {setTimeout('blinkTimer()', blinkSpeed);}
}

function trapDelete() {
//Checks to see if the key pressed is the Delete/Backspace key, and if so, stop it from getting to the browser.
var keyID = (window.event) ? event.keyCode : e.keyCode;
if (keyID==8 && !allowBackspace){
return false;
}
return true;
}

function m_keyPressed(event) {
//This is not IE-compliant code.
if (event.keyCode == 46 || event.keyCode == 8) {
if (!songsList.selection) {
return;
}

playlistName = songsList.playlistName;

if (playlistName != "Library" && playlistName != "History") {
selection = songsList.selection;
item = songsList.getByID(selection);

songsList.select(null);
sendData(url_remove, "playlist=" + songsList.playlist + "&piIx=" + item.piIx);
m_setStatus("Removed \"" + item.songName + "\" ...");
songsList.removeItem(selection);
}
}
}

function m_pingSession() {
var elapsedTime = new Date().getTime()/1000.0 - lastPing;

if (elapsedTime >= 5) {
sendData(url_ping, "");
m_sessionCheckin();
lastPing = new Date().getTime()/1000.0;
}
}

function m_sessionCheckin() {
/* A true or false value is set by the server before delivering this script
depending on preference. */
if (!{auto_logout}) {
return;
}

if (timer == null) {
timer = setInterval("m_sessionLogout()", {timeout} * 1000);
}
else {
clearInterval(timer);
timer = null;
return m_sessionCheckin();
}
}

function m_sessionLogout() {
// Sets the flag to tell confirmUnload subroutine that it is OK to let the user leave this page (close the Window, etc.)
allowUnload = true;
window.location=url_login;
}
</pre>

=================================================================================================================================================

mainscreen.html
<pre>
<html>
<head>

<title>kJams Server</title>

<script src="spry/xpath.js"></script>
<script src="spry/SpryData.js"></script>
<script src="ui.js"></script>
<script src="data.js"></script>
<script src="main.js"></script>
<script src="common.js"></script>
<script type="text/javascript">

</script>
<script type="text/javascript">
//variable to control if message is shown
var allowUnload = false;

// function triggered by any closing of the current document
function confirmUnload(){
if(!allowUnload){
//message displayed (as well as inbuilt IE junk) when page is unloaded.
return 'Why on earth would you think it is a good idea to close this window?!? Well, it ISN\'T!!! Do NOT close this window. If you do, all hell will rain down upon you, you will get A.I.D.S., and I will get very upset (at you closing the window, not the A.I.D.S., that\'s on you).\n :\'(';
}
}

//register function with the event handler
window.onbeforeunload = confirmUnload;
</script>

<link rel="stylesheet" href="screen.css" media="screen"/>
<link rel="stylesheet" href="handheld.css" media="handheld, only screen and (max-device-width:480px)"/>
</head>

<body onLoad="m_sessionCheckin()"; "loaded()" onmousemove="m_pingSession()" onclick="m_pingSession()" onkeypress="m_pingSession()" onscroll="m_pingSession()">
<div id="main">
<table><tr><td id="title"><nobr>{singer}</nobr></td><td id="search"><nobr>Search Library: <input type="search" id="searchfield" name="search" onkeypress=searchKeyPressed(event) onblur="inSearch.off()" onfocus="inSearch.on()" /><input type="submit" style="" name="dosearch" value="Go" onclick=m_doSearch() /></nobr></td><td id="help"><nobr>[ <a id="helplink" onClick="allowUnload=true" href="">Help</a> ] [ <a id="logoutlink" onClick="allowUnload=true" href="">Logout</a> ]</nobr></td></tr></table>

<div>
<div id="left">
<div id="playlists"></div>
<div id="photo"><img src="kjams-main.jpg" /></div>
</div>
<div id="wrapper">
<div id="songs"><p id="msg_error"></p><p id="msg_dosearch">Please enter a search.<br><br><b> Hint: To limit your search to just a particular artist, type "artist:" followed by the name of the artist.<br>Likewise, to search just on song names type "song name:" and then the name of your song, etc..</b></p><p id="message">Please enter a search.<br><br><i>Type your search into the search field above and hit "Go".<br><br>To submit a song, just click the "Tonight" button for that song in the search results. (You can also make your own "Favorties" list.)<br><br>You will be informed at the bottom of the screen when you have successfully submitted a song.</i><br><br><b> Hint: To limit your search to just a particular artist, type "artist:" followed by the name of the artist.<br>Likewise, to search just on song names type "song name:" and then the name of your song, etc..</b></p><p id="waiting">Please wait, loading search results… .<br><i><b>(This may take a while. <span style="color:#FF0000"><a name=blinker>Please do NOT</a> try another search until the first results are returned.)</span></b></i></p></div>
</div>
<div class="clear"></div>
<div id="status">Welcome to kJams!</div>
</div>
</div>

<script language="javascript">
//Bind key press function
document.onkeyup = m_keyPressed;
//Prevent browser from seeing the Delete key press
document.onkeydown=trapDelete;

//Hide message fields
document.getElementById("waiting").style.display = 'none';
document.getElementById("msg_dosearch").style.display = 'none';
document.getElementById("msg_error").style.display = 'none';

//Plug in help and logout URLs
document.getElementById("helplink").href = url_help;
document.getElementById("logoutlink").href = url_login;

//Playlists
m_populatePlaylists();

if (0) {
//Song list
var songs = new KJList();
songs.create(document.getElementById("songs"));
songs.setColumns(Array("#", "Song Name", "Artist", "Pitch", "Add to", "Add to"), 1);

//Set clipping
songs.setClipping({'right' : songs.getColumnWidth(5) + songs.getColumnWidth(4) + songs.getColumnWidth(3)});

getSongs(url_songs, populateList, 'playlist=1');

function populateList(songList) {
for(var i = 0; i < songList.length; i++) {
songs.addItem(songList[i]['number'], Array(songList[i]['number'], songList[i]['name'], songList[i]['artist'], "<select><option>+6</option><option>+5</option><option>+4</option><option>+3</option><option>+2</option><option>+1</option><option selected>0</option><option>-1</option><option>-2</option><option>-3</option><option>-4</option><option>-5</option></select>", "<input type=\"submit\" value=\"Tonight\" />", "<input type=\"submit\" value=\"Favorites\" />"), null, null, false);
}

songs.color();
}
}
</script>
</body>
</html>
</pre>

2012-09-04T02:56:09Z

Deusexmachina:

Server/Code/modifications to main.js

2012-09-04T02:46:53Z

Deusexmachina:

Server/Code/modifications to main.js

2012-09-04T02:46:14Z

Deusexmachina:

2012-08-21T14:43:00Z

Deusexmachina:

'''''Notes in italics'''''

''In order of priority (subject to change):''

==Arrow key nudging/time entry for blobs in Inspector==
It would be really nice if it were possible to nudge elements around on the page using the arrow keys, instead of the error-prone use of the mouse/trackpad
In the same vein, it would be very helpful to have a blob's time position editable in a field in the Inspector window, just like you can enter scrubber position by clicking in the time field on the left of the Timeline.

==Word spacing==
<span style="color:magenta;">Note: This is potentially just an incorrect assumption somewhere in the code..</span>

''Second most time consuming, because every track must be checked, it is hard to do by visual inspection, and since when a track needs one edit, it often needs MANY, and involves lots of zooming in and zooming out, and blob dragging, which is not particularly efficient in the current interface:''

Sometimes words that are supposed to be separated are not. They are placed right next to each other. E.g., "Willyou" instead of "Will you", even though they are separate words in the actually .fly file.
Because of this, although it is not particularly common, I still have to go through every track, page by page, checking to see if this has occurred. This can be time-consuming and a bit frustrating. When one is found, there are usually repeats, and editing them all can take significant amounts of time.
''Of almost equal priority, since it has to be checked in every file, and if not corrected, forces a redo (unlike the previous one, which can sneak by the quality control staff!):''

<span style="color:red;">you can also put any related song files into this folder too, and make a link to them so everything is accessible directly from this web page, like this:</span>

Test file: [http://kjams.com/screenshots/bugs/word_spacing/Archive.zip SFDT-2741 The Beatles - Tomorrow Never Knows]<br>
1:35 "nowlove" should be "now love"<br>
01:53 "theymourn" should be "they mourn"<br>
02:23 "soplay" should be "so play"<br>
<br>
There are probably more examples in this file. These are the ones in this file that slipped by my first edit, and so were brought up by SF QC.

<span style="color:magenta;">Note: I am pretty sure that this phenomenon only occurs on the first words of a line.</span>

==Better pre-post gap settings==
As discussed before, being able to set a maximum percentage to reduce the size of the final blobs on each page to accommodate the post and pre gaps, first shrinking the final blob until it reached 100 - max percentage, and then shrinking the next one, etc., until the post and pre gaps fit, would finalize this procedure.
Currently, Producer just shrinks the last blob on the "pre" page to nothing, and only then goes on to shrink the next to last blob, with the result being that the final word just flies by. this has a very disconcerting psychological effect that hampers finding your place on the next page.
:a percentage of what though? it can't be "percentage of original duration" because that can vary wildly. i think instead it should just be a "minimum duration" in seconds, then you could enter something like "0.25" for one quarter second? if this seems like it would work, let me know. -[[User:Dave|dave]] ([[User talk:Dave|talk]]) 22:56, 12 June 2012 (PDT)

No, I really do mean percentage of original duration. For instance, if the last blob needs a full second to sweep, but does not have enough time, it gets squeezed. As of now, if there is less time left in the current page than there is space, it gets squeezed to a "singularity" (no apparent width and instant sweep time). If that is still not enough, the next to last blob gets squeezed, also possibly to a singularity, and so on and so one, causing a set of lyrics that can just flash by before the whole page disappears, which is very psychologically disconcerting.
I am proposing that the last blob only gets shrunk to a certain extent, and after that, each successive blob can only be shrunk by 25% (75% of its original size) before the next left-most blob gets squeezed. This results in a minimal disruption of the timing, as well as leaving a reasonably sized blob to sweep. Because of the realities of how the pages get made, I suspect there will be few incidents where the blobs will be affected past the last three.
For instance, the bigger the penultimate blob (gotta use that word at every opportunity) the more time 25% of that blob will be, and thus the bigger cushion you have to fit the final blob. No blob should be able to be shrunk more that a certain minimal duration (enough to ensure that it will actually appear to sweep) so the amount any one blob can shrink is limited by either 75% of original size or the minimum duration parameter, whichever comes first.
For example: the final four blobs each last 0:75.3. The next page however must come up 1:50.0 after the final blob. As such, the pre and post gap settings would force the final two blobs to reduce to essentially 0:00.0, and the third to last blob being shrunk to accommodate the post gap. To prevent these word from just flashing to the sweep colour and the page disappearing it would instead reduce the final blob to the minimum blob size parameter. It would then check how much it would need to reduce the penultimate blob to accommodate the last word, which would be over 75% of its current size, so it would only be reduced by 25%. Then the penpenultimate blob would be checked. It too would have to be reduced beyond 75%, so it would hit its maximum reduction at 24%. Lastly, the third to final blob wuld be shrunk a small amount, less than 25%, which would successfully accommodate the space needed.
Alternately, if we presuppose that the second to last blob was only 0:50.0 to begin with, and the minimum blob size was set to, say, 0:40.0, shrinking the full 25% would leave a blob only 0:37.2 seconds wide, below the minimum blob size. As such, the blob would only be shrunk to 0.40.0, and the next blob to the left would have to shrink more to accommodate the difference.

But whatever works. The ultimate goal is just to prevent it from doing those instantaneous sweeps, where the singer thinks he has a certain amount of time, but the word just vanishes, and the page changes. If it is better to do it with a minimum duration in seconds, that is fine. I just suspect that it would be more accurate to the original if it were a percentage.

==Fix "save MSI default"==
Dave, this ^^^ is a separate thing® from the item below it

Right now, saving the default text and sweep colours and font size etc does NOT work. It was supposed to be fixed, but never actually was. Some things sorta, kinda, partially save, but mostly it just doesn't work.

Steps:
# Select track
# Open in Producer
# Select Get Media Info
# Change something (say, sweep colour)
# Option click "OK" to save <-- (Dialogue box comes up saying it is saved)
# Open another track that you have never opened before in Producer
# Select GMI

Note that the sweep colour is NOT the colour that you saved, but rather the original colour from before the save (or sometimes, even, another colour entirely).

Also, I have tried to edit the xml by hand, and while I can get certain things to change, I have not been able to reliably get the RIGHT thing to change. Colours seem to change at random, or sometimes not at all. If I could just get a working copy of the XML with all the right settings, then being able to correctly save wouldn't matter. I could just lock the file, and possibly swap another copy in as needed, but nothing I do in the file works reliably, and nothing really makes sense, anyway.

==The separate thing® (Meta data gets reverted)==
[[Bugs/Mark/Meta_Revert|Meta Revert]]

==Trailing Punctuation==
It would be nice if, if the final blob on a given line was punctuation, that it actually be placed directly adjacent to the previous word, rather than separated by white space.
E.g., "you …." would be "you…."
This is important stylistically, not only because of aesthetics, but because of consistency, as some times, for instance, an ellipsis will appear as part of one blob, and other times as a separate one, in the same phrase in the same sentence in the same song.
:<span style="color:red;">please provide a .fly/.mp3 pair that shows this problem</span>

I can upload, but it is any file where the punctuation is a separate blob from the word before it. So, for example, sometime they might have "love...." as a single entity, and others they may have "love" as one word, and "...." as another. As a result, kJams does what it "should" do, puts a gap between these "words".
But not only does this look bad, it makes it inconsistent when SF is inconsistent, and has it so that sometimes there is a space between words and punctuation, and sometimes there is not. IMO, there should NEVER be white space between the word and the following punctuation, be it period, ellipsis, comma, or what have you. Certainly in implementation, this could take the form of an exclusion list.

==Words with hyphens incorrectly sized==
In the YSTHs tracks, Words with hyphens get incorrectly sized. The hyphen is too long but more interestingly, the bounding box is made too big vertically. This is probably a font issue (Univers 67 condensed bold) but when I replace the hyphen in the blob with the keyboard hyphen, I get the correctly sized character. I thought the preference we added, "producer: interpret hyphens as syllable markers" was supposed to ignore syllable markers, and thus allow the standard keyboard hyphen-minus char to survive the encoding process? If not, it really should!
:<span style="color:red;">please provide a .fly/.mp3 pair that shows this problem</span>

==Can not create break screen==
Also in the YSTHs tracks, I still can not create a YSTHs-specific break screen (like "Instrumental/n 10 seconds) that does not crash kJams like a stone.
:<span style="color:red;">send me your home-made break screen and any accompanying media, and i'll see why it's crashing</span>
It might be easier for you to just recreate the same one I am trying to use. The YSTHs break screen is just red text that reads "Instrumental xx seconds". As such, I just took the standard SunFly one, deleted the SF graphic, and changed the text colour of the text asset, which had the tag [msg ].
When I do this, it crashes immediately.

In fact, no matter what I change it to, even if it has no tag at all, if the screen specified in the prefs is not the SF one, and the track has a break, it crashes.

:<span style="color:red;">definitely easier (for me) if you give me something to work with that is already crashing</span>

<span style="color:magenta;">I think you said this is fixed, no?</span>

==AE Video Insert==
In the last YSTHs issue, it would be nice if I could get a video upcard out of AE that I could correctly paste into QT. As it is now, I get a time code error, and as such, am forced to use AE to re-encode the entire video, just to add the terminating upcard onto the end.
Don't know if this is an AE error, or something I am doing wrong.

Note: I think I have fixed this, by opening the asset in QT, and exporting using QT.

:<span style="color:red;">send me an AE project and accompanying media, that has an RQ item that exports the file you wish could be pasted into QT, and i'll have a look at it</span>
As mentioned, I got it to work, by bypassing AE, and using QT to reencode.
That said, I uploaded the assets along while ago, back when I first brought this up, and they are still on the server. I do believe you opened them then and got the same error trying to C&P in QT.

==FLY file fail==
Certain .FLY files still do not convert correctly. There appears to be either a math error or a faulty assumption that breaks certain files. I will upload one (Madonna - Borderline) to the FTP.
:<span style="color:red;">yep, let me know</span>
Test files: [http://kjams.com/screenshots/bugs/fly_fail/Archive.zip Two versions of Madonna - Borderline]<br>

==Crash / slow switching venues==
Switching venues multiple times, as I have to do in my copy singers script, often crashed kJams.
:send dem crash reports (with log files)

It is also '''SLOWWWWW''', but I suspect fixing that will require a re-architecting.
:i've done some optimizations for r57, let me know

==Random crashes==
''Heads up:'' There is still an issue of random crashes, I think server-related, but not sure. More data coming if I can catch it with Activity monitor and get code samples.

As discussed, probably not server related. OSX related.

==Editing a playlist for case==
Editing a playlist for case does not do anything<br>
<span style="color:red;">Fixed in r54+</span>

==Duration missing==
kJams does not appear to be properly pulling metadata. As of a few versions ago, Most items in the library no longer have an entry for duration. This effects several items, including estimating rotation times.
==quit producer with cmd-.==
Hitting cmd-. while in an editable text box in Producer does NOT quit Producer (as expected) rather it nulls out the text field, in an obnoxiously non-undoable fasion.

==Mark Song as Sung==
Please please PLEASE add a "Mark Song as Sung" context menu to a song in a singer's tonight list. Many times there is a song with a LONG outro that you want to fade out and move to the next song, but when you do so, the song fails to be added to the singer's History list.

<span style="color:blue;">New</span>
==Warn in Producer if trying to quit without saving current changes==

==Hyphens as syllable separators does not appear to work with FLY files.==
Whether set to true or false, the hyphen still shows up, and does not join the words together, as in latest e-mail, reproduced below:

So sometimes SF texters, for whatever reason. split words on syllable boundaries. However, there is no clear delineation, like with KTP, or how to rejoin them. So I figured I could find those leading syllables, add a hyphen in the fly file, and trick kJams into stitching them back together. For instance, the following:
<dtIcdgEventText>
<TextID>6</TextID>
<HeaderID>0</HeaderID>
<PageID>3</PageID>
<orderPageTLBR>3</orderPageTLBR>
<orderGlobal>9</orderGlobal>
<StartX>117</StartX>
<StartY>521</StartY>
<EndX>136</EndX>
<EndY>553</EndY>
<VoiceID>1</VoiceID>
<LyricText>lo</LyricText>
<hiliteStartATimeMinutes>0</hiliteStartATimeMinutes>
<hiliteStartATimeSeconds>23</hiliteStartATimeSeconds>
<hiliteStartATimeFrames>40</hiliteStartATimeFrames>
<hiliteDurATimeMinutes>0</hiliteDurATimeMinutes>
<hiliteDurATimeSeconds>1</hiliteDurATimeSeconds>
<hiliteDurATimeFrames>46</hiliteDurATimeFrames>
</dtIcdgEventText>
<dtIcdgEventText>
<TextID>7</TextID>
<HeaderID>0</HeaderID>
<PageID>3</PageID>
<orderPageTLBR>4</orderPageTLBR>
<orderGlobal>10</orderGlobal>
<StartX>136</StartX>
<StartY>521</StartY>
<EndX>187</EndX>
<EndY>553</EndY>
<VoiceID>1</VoiceID>
<LyricText>sing </LyricText>

which should be "losing" but shows as "lo sing", and changing it to:

<dtIcdgEventText>
<TextID>6</TextID>
<HeaderID>0</HeaderID>
<PageID>3</PageID>
<orderPageTLBR>3</orderPageTLBR>
<orderGlobal>9</orderGlobal>
<StartX>117</StartX>
<StartY>521</StartY>
<EndX>136</EndX>
<EndY>553</EndY>
<VoiceID>1</VoiceID>
<LyricText>lo- </LyricText>
<hiliteStartATimeMinutes>0</hiliteStartATimeMinutes>
<hiliteStartATimeSeconds>23</hiliteStartATimeSeconds>
<hiliteStartATimeFrames>40</hiliteStartATimeFrames>
<hiliteDurATimeMinutes>0</hiliteDurATimeMinutes>
<hiliteDurATimeSeconds>1</hiliteDurATimeSeconds>
<hiliteDurATimeFrames>46</hiliteDurATimeFrames>
</dtIcdgEventText>
<dtIcdgEventText>
<TextID>7</TextID>
<HeaderID>0</HeaderID>
<PageID>3</PageID>
<orderPageTLBR>4</orderPageTLBR>
<orderGlobal>10</orderGlobal>
<StartX>136</StartX>
<StartY>521</StartY>
<EndX>187</EndX>
<EndY>553</EndY>
<VoiceID>1</VoiceID>
<LyricText>sing </LyricText>

which SHOULD be "losing" (Syllables stitched together by kJams) but instead shows up as "lo-sing" (no white space).

What is wrong with my thought process here?