Web page and users¶

6. Web page¶

6.1 Opening and logging in¶

Phone, tablet or PC must be in the same WLAN as the box.
Open https://tinyjukebox.local in the browser (a further box has a name of its own: section 13.2).
The first time, the browser warns about the certificate: the box issues it for itself. Confirm the warning ("Advanced" → "Proceed to tinyjukebox.local" or similar).
Choose the language: the page is English the first time. The choice "Deutsch / English" is below the login, after the login at the top right, and in the tab "System".
Log in with user name and password.
Above the login it says where you are: "Library", "Box" or the box with its name, e.g. Box "antonia". Every box has colors of its own; they follow from its name (a box without a name has fixed colors as well). So you also see after the login which box you are on.
The browser remembers the language, for this device and this box. On another device and on the page of another box or of the library it is chosen once again.
The login stays. A new login is needed after 7 days without use, and on an open page on which nothing was done for 30 minutes (section 11).
After 5 wrong passwords every further failed attempt blocks the login from this device for 30 seconds.

6.2 Roles¶

Role	may
`user`	look at almost everything and operate the box: pause, track, volume, place tags; scan new tags with the phone in the library; change the own password
`admin`	in addition change everything: albums, tags, radio stations, covers, pair a headset, volume limits, users

Only the role admin sees the tabs "Upload" and "Log", all buttons that change something, and these parts of the page: in the tab "System" "Check consistency" and the cards "Hardware", "Backup", "Version" and "Users"; in the tab "Spotify" the cards "Account" and "Player"; in the library the cards "Add a box", "Add a phone" and "Access for boxes and scripts" (tab "Boxes"), "Access to the releases" (tab "Versions") and "The app on phones" (tab "Spotify").

6.3 Tabs¶

Tab	Content
Now	what is playing: cover, album, track, position, list of tracks. Buttons back, pause/play, next, "Album from the start"; volume with slider and buttons. If an unknown tag is on the box: choose an album and "Link & play".
Tags	the tab for everyday use: all tags with the cover of their album or station, as tiles or as a list ("Tiles" / "List"), all of them or only those of albums, of radio stations or of Spotify ("All" / "Albums" / "Radio" / "Spotify"). The page remembers the choice. A click places the tag on the box as if it really stood there; a second click or "Take off tag" takes it off again.
Tag management	all tags with cover, name, UID, album or station and progress. Here tags are created, named, linked, unlinked and deleted.
Albums	a list of all albums for managing them: cover, title, number of tracks, playing time, tags, the day they were added and the folder. A click on a column heading sorts by it, a second click turns the order round. A click on the title opens the album: title and cover (both can be changed), list of tracks, linked tags, problems. "Look for new folders" takes in albums that were copied to the box directly.
Radio	all radio stations: create, rename, change the address, choose a cover, test, delete
Spotify	the entries of Spotify: create from a link, rename, change the link, choose a cover, test, delete; on a box also the account and the player (section 9)
Bluetooth	the paired headset: name, connected, battery, volume, start value and maximum; "Pair" and "Unpair"
Statistics	what was listened to on this box: per tag (a click on a column heading sorts the table by it, a second one turns the order round), per calendar day with the hours between which something was listened to, on speaker or headset, per radio station; skipped tracks; per version of the box software starts, errors and fallbacks, for how many days it was installed and for how many hours the box was switched on with it (total) and played something (active); at the very end the tags that were never placed. The library does the counting: if it cannot be reached, the tab says so. A box without a library counts by itself and reaches as far back as the last 1000 entries of its journal.
Upload	create a new album from MP3 files
System	state of the box, language of the page, "Check consistency", "Reset progress", hardware (state of buttons, LED and RFID reader, for troubleshooting), backup (section 11.1), library (section 13.2), version (section 13.4), change own password, users, progress per tag
Log	the messages of the box, live, with a filter; "Save as file"

The buttons in the tab "Now" act like the buttons of the box.

Help: "Help" at the top opens this manual at the chapter of the tab that is open, in the language of the page; an admin finds the administration there too. The box brings the help along – it works without the internet and is that of the version the box runs. After a login a hint points to the quick guide, until "Do not show it again" is ticked; the browser keeps that.

10. Limiting the volume¶

Speaker and headset each have a start value and a maximum:

	Start value	Maximum
Speaker	applies when the box is switched on	applies always
Headset	applies every time it connects	applies always, also for the buttons on the headset

Changing them (role admin): tab "Now", "change" below the volume slider – or tab "Bluetooth", "Change start value and maximum".

The rule is: 0 ≤ start value ≤ maximum ≤ 100.
A lowered maximum lowers a higher current volume at once.
A new start value takes effect the next time the box is switched on or the headset connects.
The values are kept, also after switching off.
The role user sees the values but cannot change them. So nobody changes the hearing protection in passing.
The box can limit the buttons on the headset only for headsets that align their volume with the box ("Absolute Volume"). The volume that the box itself sets is always limited.

11. Users and passwords¶

Change own password (every user): tab "System", "Change own password" – with the current password. A new login is needed on all other devices afterwards.
Managing users (role admin): tab "System", "Users" – create a user (role user or admin), set a password, delete.
A new password logs the user out on every other device.
The own user cannot be deleted. So there is always an admin.
The role of an existing user cannot be changed on the web page: delete the user and create it again.
Passwords have at least 8 characters.
Logged out by itself: besides the 7 days without use (section 6.1), an open page on which nothing was done for 30 minutes logs out and says so on the login page. Moving the mouse, a tap or a key counts as doing something; an upload that runs counts too. The time can be changed or switched off in the config of the box or of the library (configuration.md, section 5).
Password forgotten: an admin sets a new one. If no admin knows the password any more, only access to the box itself helps (operations.md, section 4).

11.1 Backup¶

A backup is a file with the data of the box: tags, links, progress, volumes and the covers of albums and stations. Only the role admin can make one.

Tab "System", "Backup": "Download backup" saves the file on the device you are sitting at. It is small.
"Download backup with MP3s" takes the albums along as well. The file is then as large as all albums together, and the download takes that long.
Users, passwords and keys are never in a backup.
A box that works with a library needs no backup of its own: everything is in the library, and the library backs itself up (section 13.6).

11.2 Back up regularly¶

A box that works without a library – and the library (section 13.6) – makes backups by itself: tab "System", card "Backup", "Back up regularly". There are two schedules, independent of each other: one for the backups without MP3s, one for those with MP3s.

Setting	Meaning
regularly	Backups of this kind are made by themselves.
every … at …	how often – a number of days, weeks or months – and at what time of day. With months: on the same day of the month as the last backup.
… backups are kept	Older backups of this kind are deleted.
Folder	where these backups are put. Empty: the given folder, on a box `backups` beside the albums.

An example: without MP3s every week, 52 kept – a year of small backups; with MP3s every month, 2 kept – the current one and the one before, each as large as all albums.
"Save" takes over the settings of both schedules. "Back up now" and "Back up now with MP3s" make a backup at once; it goes into the folder of its kind and counts for its number.
The table below shows the backups of both folders with their kind. Each can be downloaded and deleted.
Under each schedule it says where its backups are, when the last one was made and when the next one is due – or why the last one failed.
If a folder is changed, the previous backups stay in the old folder.
A box that works with a library does not show this part: the library makes the backups. The settings are kept and count again if the box is unlinked from the library.
On a box the backups lie on its SD card, like the data itself. Against a broken card only a backup helps that was downloaded, or a folder on another drive.

11.3 Putting a backup back¶

A backup replaces the data of the box – or of the library – by those of the day it was made. Only the role admin can do it: tab "System", card "Backup", "Put a backup back".

"Choose backup …" and choose the file on the device you are sitting at. With a backup that was made by a schedule: "Put back" next to it in the table.
The backup is sent and read to its end; with MP3s this takes as long as a download. A file that is no backup, is cut off or belongs to the library and not to a box is refused – nothing is changed then.
The page asks once: "This replaces all data by those of …". With MP3s all albums are deleted and replaced. Cancel, and nothing is changed.
After "OK" the box (or the library) stops, puts the data in place and starts again. The page loads anew; log in again.
No backup is made before. If the data of now may be needed again: cancel and download a backup first.
Users, passwords, keys and where the backups go stay as they are.
A backup without MP3s leaves the albums as they are. If the data names an album whose folder is gone, the card says so afterwards and names it.
A box that works with a library gets the state of the library again at its next synchronization. Put a backup back on the library instead (section 13.6).