Server - Revision history

Dave at 16:26, 3 May 2022

2022-05-03T16:26:15Z

← Older revision		Revision as of 16:26, 3 May 2022
Line 4:		Line 4:

	==Take Note==		==Take Note==
	Singers created in the kJams app by the host (rather than thru the web interface or thru '''~~wtkJams~~''') 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\|context click]] the singer and pick "Get Info", then type a password.		Singers created in the kJams app by the host (rather than thru the web interface or thru '''kJams Cue''') 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\|context click]] the singer and pick "Get Info", then type a password.

	==Playlist used for Server Search==		==Playlist used for Server Search==
Line 32:		Line 32:
	The web server will be on port 80 (or whatever other port you've configured it to) on the IP address which your computer or laptop is set to on the local network, whether wireless (usually) or wired.		The web server will be on port 80 (or whatever other port you've configured it to) on the IP address which your computer or laptop is set to on the local network, whether wireless (usually) or wired.

	To make it easier to find, both for [[~~wtkJams~~]] and for users accessing it with a standard web browser on their phone, tablet, or laptop, kJams uses Apple's 'Bonjour' service discovery protocol. You will need to install a "Bonjour Browser" to easily find the kJams venue, or you can locate it manually		To make it easier to find, both for [[kJams Cue]] and for users accessing it with a standard web browser on their phone, tablet, or laptop, kJams uses Apple's 'Bonjour' service discovery protocol. You will need to install a "Bonjour Browser" to easily find the kJams venue, or you can locate it manually
	=== If you're using Windows ===		=== If you're using Windows ===
	# Required install [http://support.apple.com/kb/DL999 Bonjour for Windows] (it says "Print Services" but it's the real Bonjour)		# Required install [http://support.apple.com/kb/DL999 Bonjour for Windows] (it says "Print Services" but it's the real Bonjour)

Dave at 16:32, 28 April 2022

2022-04-28T16:32:35Z

← Older revision		Revision as of 16:32, 28 April 2022
Line 1:		Line 1:
	"'''kJams Pro'''" and "'''kJams 2'''" allow the KJ to enable a '''web server''' that is built into kJams. It allows singers to use the app '''[[~~wtkJams~~]]''' or a web browser to manage their "Tonight", "Favorites", and "History" playlists. Singers can search the KJ's Library, or search any of their playlists to find songs they can then put into their "Tonight" playlist. They can reorder their "Tonight" list so the songs come in the order in which they want to sing them, and they can change the key of any song.		"'''kJams Pro'''" and "'''kJams 2'''" allow the KJ to enable a '''web server''' that is built into kJams. It allows singers to use the app '''[[kJams Cue]]''' or a web browser to manage their "Tonight", "Favorites", and "History" playlists. Singers can search the KJ's Library, or search any of their playlists to find songs they can then put into their "Tonight" playlist. They can reorder their "Tonight" list so the songs come in the order in which they want to sing them, and they can change the key of any song.

	Note: Internet Explorer and Opera are not supported. You must use FireFox, Safari, or, with a little work, Chrome.		Note: Internet Explorer and Opera are not supported. You must use FireFox, Safari, or, with a little work, Chrome.

Dave at 16:32, 28 April 2022

2022-04-28T16:32:19Z

← Older revision		Revision as of 16:32, 28 April 2022
Line 1:		Line 1:
	"'''kJams Pro'''" and "'''kJams 2'''" allow the KJ to enable a '''web server''' that is built into kJams. ~~This~~ allows singers to use the app '''[[wtkJams]]''' or a web browser to manage their "Tonight", "Favorites", and "History" playlists. Singers can search the KJ's Library, or search any of their playlists to find songs they can then put into their "Tonight" playlist. They can reorder their "Tonight" list so the songs come in the order in which they want to sing them, and they can change the key of any song.		"'''kJams Pro'''" and "'''kJams 2'''" allow the KJ to enable a '''web server''' that is built into kJams. It allows singers to use the app '''[[wtkJams]]''' or a web browser to manage their "Tonight", "Favorites", and "History" playlists. Singers can search the KJ's Library, or search any of their playlists to find songs they can then put into their "Tonight" playlist. They can reorder their "Tonight" list so the songs come in the order in which they want to sing them, and they can change the key of any song.

	Note: Internet Explorer and Opera are not supported. You must use FireFox, Safari, or, with a little work, Chrome.		Note: Internet Explorer and Opera are not supported. You must use FireFox, Safari, or, with a little work, Chrome.

Dave at 16:26, 15 April 2022

2022-04-15T16:26:19Z

← Older revision		Revision as of 16:26, 15 April 2022
Line 1:		Line 1:
	"'''kJams Pro'''" and "'''kJams 2'''" allow the KJ to enable a '''web server''' that is built into kJams. This allows singers to use the app '''[[wtkJams]]''' or a web browser ~~to manage their queues. The app / web site allow singers~~ to manage their "Tonight", "Favorites", and "History" playlists. Singers can search the KJ's Library, or search any of their playlists to find songs they can then put into their "Tonight" playlist. They can reorder their "Tonight" list so the songs come in the order in which they want to sing them, and they can change the key of any song.		"'''kJams Pro'''" and "'''kJams 2'''" allow the KJ to enable a '''web server''' that is built into kJams. This allows singers to use the app '''[[wtkJams]]''' or a web browser to manage their "Tonight", "Favorites", and "History" playlists. Singers can search the KJ's Library, or search any of their playlists to find songs they can then put into their "Tonight" playlist. They can reorder their "Tonight" list so the songs come in the order in which they want to sing them, and they can change the key of any song.

	Note: Internet Explorer and Opera are not supported. You must use FireFox, Safari, or, with a little work, Chrome.		Note: Internet Explorer and Opera are not supported. You must use FireFox, Safari, or, with a little work, Chrome.

Dave at 16:25, 15 April 2022

2022-04-15T16:25:18Z

Dave: /* How To Turn It On */

2020-11-19T00:49:01Z

How To Turn It On

← Older revision		Revision as of 00:49, 19 November 2020
Line 23:		Line 23:
	## in the "startup type" menu, pick "disabled"		## in the "startup type" menu, pick "disabled"
	## click "Apply"		## click "Apply"
			# run kJams
	# To enable existing singers for remote login, right click on each singer and pick "Get info..." and enter a password.		# To enable existing singers for remote login, right click on each singer and pick "Get info..." and enter a password.
	# go to "Preferences"		# go to "kJams->Preferences->Server"
	~~# Click "~~Server".
	# Check "Enable kJams Web Server"		# Check "Enable kJams Web Server"
	# Keep the default port number (80) unless you're already running a web server. If you are, try 12345 as your port.		# Keep the default port number (80) unless you're already running your own web server. If you are, try 12345 as your port.

	==Testing the Web Server==		==Testing the Web Server==

Dave: /* How To Turn It On */

2020-11-19T00:47:58Z

How To Turn It On

← Older revision		Revision as of 00:47, 19 November 2020
Line 14:		Line 14:

	==How To Turn It On==		==How To Turn It On==
			# for Windows users only:
			## Click the start menu
			## Type in "Services"
			## Sort by Name
			## Scroll down to World Wide Web Publishing Service (W3SVC)
			## right click it and pick "Properties"
			## if it is running, click "stop"
			## in the "startup type" menu, pick "disabled"
			## click "Apply"
	# To enable existing singers for remote login, right click on each singer and pick "Get info..." and enter a password.		# To enable existing singers for remote login, right click on each singer and pick "Get info..." and enter a password.
	# go to "Preferences"		# go to "Preferences"

Dave: /* Install a Bonjour Browser */

2019-08-08T20:16:12Z

Install a Bonjour Browser

← Older revision		Revision as of 20:16, 8 August 2019
Line 29:		Line 29:

	==== Install a Bonjour Browser ====		==== Install a Bonjour Browser ====
	Mac: [~~https~~://~~hobbyistsoftware~~.com/~~bonjourbrowser~~ Bonjour Browser]<br>		Mac: [http://www.tildesoft.com/ Bonjour Browser]<br>
	Windows: [https://hobbyistsoftware.com/bonjourbrowser Bonjour Browser]		Windows: [https://hobbyistsoftware.com/bonjourbrowser Bonjour Browser]

Dave: /* Install a Bonjour Browser */

2018-07-09T21:39:47Z

Install a Bonjour Browser

← Older revision		Revision as of 21:39, 9 July 2018
Line 29:		Line 29:

	==== Install a Bonjour Browser ====		==== Install a Bonjour Browser ====
	Mac: [https://hobbyistsoftware.com/bonjourbrowser Bonjour Browser]<br>-		Mac: [https://hobbyistsoftware.com/bonjourbrowser Bonjour Browser]<br>
	Windows: [https://hobbyistsoftware.com/bonjourbrowser Bonjour Browser]		Windows: [https://hobbyistsoftware.com/bonjourbrowser Bonjour Browser]

Dave: /* Install a Bonjour Browser */

2018-07-09T21:39:34Z

Install a Bonjour Browser

← Older revision		Revision as of 21:39, 9 July 2018
Line 29:		Line 29:

	==== Install a Bonjour Browser ====		==== Install a Bonjour Browser ====
	Mac: [https://hobbyistsoftware.com/bonjourbrowser Bonjour Browser]		Mac: [https://hobbyistsoftware.com/bonjourbrowser Bonjour Browser]<br>-
	Windows: [https://hobbyistsoftware.com/bonjourbrowser Bonjour Browser]		Windows: [https://hobbyistsoftware.com/bonjourbrowser Bonjour Browser]

← Older revision		Revision as of 16:25, 15 April 2022
Line 1:		Line 1:
	~~In the~~ Pro ~~version,~~ and ~~in kJams2,~~ 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.		"'''kJams Pro'''" and "'''kJams 2'''" allow the KJ to enable a '''web server''' that is built into kJams. This allows singers to use the app '''[[wtkJams]]''' or a web browser to manage their queues. The app / web site allow singers to manage their "Tonight", "Favorites", and "History" playlists. Singers can search the KJ's Library, or search any of their playlists to find songs they can then put into their "Tonight" playlist. They can reorder their "Tonight" list so the songs come in the order in which they want to sing them, and they can change the key of any song.

	Note: Internet Explorer and Opera are not supported. You must use FireFox, Safari, or, with a little work, Chrome.		Note: Internet Explorer and Opera are not supported. You must use FireFox, Safari, or, with a little work, Chrome.

	==Take Note==		==Take Note==
	Singers created by the host ~~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\|context click]] the singer and pick "Get Info", then type a password.		Singers created in the kJams app by the host (rather than thru the web interface or thru '''wtkJams''') 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\|context click]] the singer and pick "Get Info", then type a password.

	==Playlist used for Server Search==		==Playlist used for Server Search==
	By default, the playlist that is searched by the server is the Library. However, the host can change this to any other playlist if desired, by [[Context_Click\|context-clicking]] the playlist and choosing "Playlist used for Server Search".		By default, the playlist that is searched by the server is the Library. However, the host can change this to any other playlist if desired, by [[Context_Click\|context-clicking]] the playlist and choosing "Playlist used for Server Search".

	This is handy if, for example, you have every song in the world in your Library, but only want a subset to be visible for user searches when they use the web server. This setting is remembered per-venue. Only one Playlist may be used for the Server Search.		This is handy if, for example, you have every song in the world in your Library, but only want a subset to be visible for user searches when they use the web server. This setting is remembered per-venue. Only one Playlist may be used for the Server Search.
Line 27:		Line 27:
	# go to "kJams->Preferences->Server"		# go to "kJams->Preferences->Server"
	# Check "Enable kJams Web Server"		# Check "Enable kJams Web Server"
	# Keep the default port number (80) unless you're already running your own web server. If you are, try 12345 as your port.		# Keep the default port number (80) unless you're already running your own web server. If you are, try 12345 as your port.

	==Testing the Web Server==		==Testing the Web Server==
	The web server will be on port 80 (or whatever other port you've configured it to) on the IP address which your computer or laptop is set to on the local network, whether wireless (usually) or wired.		The web server will be on port 80 (or whatever other port you've configured it to) on the IP address which your computer or laptop is set to on the local network, whether wireless (usually) or wired.

	To make it easier to find, both for [[wtkJams]] and for users accessing it with a standard web browser on their phone, tablet, or laptop, kJams uses Apple's 'Bonjour' service discovery protocol. You will need to install a "Bonjour Browser" to easily find the kJams venue, or you can locate it manually		To make it easier to find, both for [[wtkJams]] and for users accessing it with a standard web browser on their phone, tablet, or laptop, kJams uses Apple's 'Bonjour' service discovery protocol. You will need to install a "Bonjour Browser" to easily find the kJams venue, or you can locate it manually
Line 42:		Line 42:

	=== Locate it Manually ===		=== Locate it Manually ===
	One option is to run kJams, then go to the Video menu and pick "QR Code-Web Server". This will display a QRCode grid on the Video screen. Have your singer scan that with a QR-Reader app on their smart phone, this will take them right to the your kJams Server.		One option is to run kJams, then go to the Video menu and pick "QR Code-Web Server". This will display a QRCode grid on the Video screen. Have your singer scan that with a QR-Reader app on their smart phone, this will take them right to the your kJams Server.

	Otherwise, you must find out the "sharing name" of your server machine		Otherwise, you must find out the "sharing name" of your server machine
	# Mac: in System Preferences->sharing, eg: "bree.local"		# Mac: in System Preferences->sharing, eg: "bree.local"
	# Windows:		# Windows:
	## start menu->control panels->system->computer name. That plus ".local" is your "sharing name". eg: if your "computer name" is "bree" then your "sharing name" is "bree.local"		## start menu->control panels->system->computer name. That plus ".local" is your "sharing name". eg: if your "computer name" is "bree" then your "sharing name" is "bree.local"
	## If the above doesn't work: start->control panels->network and sharing->change adapter settings->double click the LAN adapter->details->IPv4 address: that set of four numbers is your "sharing name", go figure.		## If the above doesn't work: start->control panels->network and sharing->change adapter settings->double click the LAN adapter->details->IPv4 address: that set of four numbers is your "sharing name", go figure.
	# to get the full address, you must append ":<port number>" to the sharing name unless it is 80. eg: if your port number is 12345, and your "sharing name" is "bree.local", the full address will be "bree.local:12345". if the port is 80, you do not need to append anything.		# to get the full address, you must append ":<port number>" to the sharing name unless it is 80. eg: if your port number is 12345, and your "sharing name" is "bree.local", the full address will be "bree.local:12345". if the port is 80, you do not need to append anything.
	# Go to any computer on your LAN, and in the web browser, enter the full address.		# Go to any computer on your LAN, and in the web browser, enter the full address.

Line 56:		Line 56:

	==If you're hyper savvy==		==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:		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:

	https://karaoke.kjams.com:12345/		https://karaoke.kjams.com:12345/
Line 62:		Line 62:
	and then set up their tonight list, before they even get to the venue! isn't that spiffy?		and then set up their tonight list, before they even get to the venue! isn't that spiffy?

	The below is FOR EXPERTS ONLY. If you don't understand something, you'll have to seek the advice of someone who knows what they're doing to help you, this is outside the purview of kJams tech support.		The below is FOR EXPERTS ONLY. If you don't understand something, you'll have to seek the advice of someone who knows what they're doing to help you, this is outside the purview of kJams tech support.

	# get a domain of your own		# get a domain of your own
Line 74:		Line 74:
	Now, when people go to your domain, they'll get to your kJams server!		Now, when people go to your domain, they'll get to your kJams server!

	Before your show, quit kJams on the server and copy the "kJams Library" folder to your rig. Run your show. After your show, copy it back and run kJams on the server again.		Before your show, quit kJams on the server and copy the "kJams Library" folder to your rig. Run your show. After your show, copy it back and run kJams on the server again.

	== Known Issues ==		== Known Issues ==
Line 82:		Line 82:

	==Updates to the Server Resources==		==Updates to the Server Resources==
	The "Server resources" are the HTML, CSS, and Javascript files that make the singer-request webserver work. They live in a the preferences folder for kJams, on your hard drive. When you first run kJams, it copies them to its preferences directory, where kJams will subsequently look for them, so that you can edit them yourself, to do things like insert your show service's logo.		The "Server resources" are the HTML, CSS, and Javascript files that make the singer-request webserver work They live in a the preferences folder for kJams, on your hard drive. When you first run kJams, it copies them to its preferences directory, where kJams will subsequently look for them, so that you can edit them yourself, to do things like insert your show service's logo.

	When there is an update to the server resources, kJams will ask you if you'd like to automatically update them.		When there is an update to the server resources, kJams will ask you if you'd like to automatically update them.

	Warning: If you HAVE made changes to them, you have to [[Server/Update\|manually update]] these files, otherwise you can just click "Update" when it asks.		Warning: If you HAVE made changes to them, you have to [[Server/Update\|manually update]] these files, otherwise you can just click "Update" when it asks.