Server

In the Pro version, kJams allows the KJ to enable a web server that is built right into kJams, which allows singers to use a web browser (even from a mobile phone) or the iJams or wtkJams application to manage their queues. Basically it will allow singers to log in and manage their "Tonight", "Favorites", and "History" playlists. They can search the Library or any of their singer lists to find songs they can then put into their "Tonight" list. They can reorder their "Tonight" list so the songs come in the order in which they want to sing them.

Note: Internet Explorer is not supported. If you use Windows to access kJams, you must use FireFox, Safari, or, with a little work, Chrome.

Take Note

Singers created in kJams (rather than thru the web interface or thru an iPhone) do not have a password. Singers without passwords will NOT show up in the list of singers that can be logged into. To assign a password to a singer so they can log in, in kJams context click the singer and pick "Get Info", then type a password.

How To Turn It On

1. To enable existing singers for remote login, right click on the singer and pick "get info" and enter a password.
2. go to "Preferences"
3. Click "Sharing".
4. Check "Enable kJams Web Server"
5. Enter a port number or keep the default eg: 12345
6. if you're using Safari, just browse your Bonjour sites for "kJams: <Venue Name>". So for example if your venue is called "Prancing Pony", then you'll look in safari for "Bookmarks->Bonjour->kJams: Prancing Pony"
7. if you're going to be using another browser, then:
   1. If you're using Windows, you can install Bonjour for Windows
   2. or you need to find out the sharing name of your server machine (in System Preferences->sharing, eg: "bree.local")
   3. Go to a machine on your local network and enter the kJams Server url eg: http://kjams.com:12345 (un: dave, pw: a)

Send me some feedback on what works and what doesn't, and what you need to make it better. Thanks!

If you don't have wireless

If you don't have a wireless network, you can set up an Ad-Hoc network.

1. Create a new network
   
   
2. name the network
   
   
3. run kjams
4. click on the folder "Singers", this is actually the venue name
5. click it again without moving the mouse, this will let you rename the folder
6. name the venue
   
   
7. go to preferences->server
8. turn on the server (see above "How To Turn it On" for more info)
   
   
9. now, on your iPhone, go to Settings->WiFi and pick the Ad-Hoc network. Note: to pick it, tap the NAME, not the blue arrow on the right.
   
   
10. run iJams or wtkJams
11. pick your Venue
    
    
12. You're ready!!
    
    

If you're hyper savvy

You can put this on a *public* IP address under some domain, and use port 80 (provided there's no other web server on that address). that way people can *from home* enter something like:

http://kjams.com:12345/

and then set up their tonight list, before they even get to the venue! isn't that spiffy?

Known Issues

• Any list (singers or songs) with more than 200 items will say "too many hits, refine your search" or something like that. (there is a secret pref you can change for this)
• A failed login (i.e., bad password) will not display an error; it will just display the login page again.
• The album selector doesn't actually do anything (yet).
• Updates made in kJams don't show up in the web UI until the playlist is refreshed. This will be addressed after 1.0.

Code

if you're a code monkey and stuff you can look here