Audiobooks and music

Audiobooks and music from your own machine - with a shelf for each

tgarr plays sound files in the browser: audiobooks on a shelf of their own, played file after file in order, and music with lyrics and favourites. It is a plain player, not an audiobook specialist - further down is the list of what it does not do.

tgarr's Media Center with its four shelves: Watch, Listen, Read and Photos
The Media Center. Listen is the second of its four shelves. (There is no picture of the player itself on this site yet.)

The playerWhat it does

The Music page is a list of sound files with a player along the bottom. Click a row and it plays; when a file ends, the next row starts.

Play, seek, go on

Play and pause, previous and next, a bar to seek on, shuffle. Previous first goes back to the start of the file when it has run for more than four seconds.

Lyrics

The Now playing view shows the cover, the lyrics and a moving spectrum. Timed lyrics are lit line by line, and a click on a line jumps there. Lyrics and spectrum can each be switched off.

Favourites and download

A heart on every row and in the player; a filter shows only the favourites. Every file can be downloaded as it is.

Finding things

Search by title, performer or file name. Sort by best, recent, longest or largest. Narrow the list by language, by source - Telegram, Usenet, Internet Archive, My files - or to what is already saved on your machine.

Keys

Space play and pause, n next, p previous, f favourite, l the Now playing view, Esc closes it.

On a phone

The same page in the phone's browser; the player folds onto two rows. Title, artist and cover are handed to the device's media controls. There is no app to install.

About lyrics. A FLAC file's own lyrics tag is used first. Otherwise tgarr asks lrclib.net and sends the title, the artist and the length of the track - nothing else. The answer is kept on your machine, so a song is asked for once. Nothing is asked until somebody plays the song with lyrics switched on.

AudiobooksA shelf of their own

Books that are listened to stand apart from songs: the Audiobooks button on the Music page and in the Library opens their shelf.

Told from music by what they are

Not by length - an hour of sound is as often a concert. A file is an audiobook when it is an .m4b, when it lies in a folder called audiobooks, when it was fetched from an Audiobooks shelf, or when its name, title or album says so: audiobook, unabridged, 有声书, 听书, 评书.

In order

The shelf starts sorted In order: book by book - by album, else by folder - and inside a book by the first number in each file's name. So chapter 2 comes after chapter 1, and the player goes on from file to file.

The place is kept - once

On this shelf the player notes the file and the second every five seconds and returns there next time. It is kept in the browser you listen in, and it is one place: the last file you heard, not one for each book.

MaterialWhere audiobooks come from

tgarr comes empty and recommends nothing. What you add is yours to choose and to answer for.

For childrenThe Listen shelf of the Media Center

Set a PIN and every browser without it gets the Media Center only. Its Listen shelf shows the sound files a parent ticked - whole collections or single files - as large cards, with a box to search them. Nothing else can be reached, also not by typing an address.

Time rules

Opening hours for school days and weekends, minutes a day, a break after so long in one go. They hold for listening as for everything else. For family learning.

A record you keep

What was opened in the Media Center is noted per child or per device, on your machine only.

Simpler than the Music page

On the Listen shelf music and audiobooks stand together - what is already on your machine first, then the newest - and each file opens by itself with the browser's own audio controls. It does not go on to the next chapter by itself, and it shows no lyrics. The player described above is on the Music page, behind the PIN.

The Playroom look of the Media Center: four big coloured cards for Watch, Listen, Read and Photos
The Media Center on a phone
Playroom, the look for the youngest, and the Media Center on a phone. Listen is one of the four cards.

The other way to listenRead aloud

A book that exists only as text can be listened to as well. tgarr's reader has a Read aloud button for e-books and PDFs: it reads from the page you are on and turns the pages as it goes. With the optional voice installed, the reading is done on your own machine in Chinese and in English; otherwise the browser's own voices are used. Voice and speed can be chosen. In the Media Center this works for a child too.

HonestlyWhat it does not do

If audiobooks are the main thing you want, Audiobookshelf is the specialist: phone apps, a sleep timer, chapters, and the place kept across devices. tgarr suits a household that wants audiobooks beside its films, books and photos, behind one children's list. How tgarr compares.

InstallPut it on a computer that stays on

Windows 10 / 11

Download one file and double-click it - no terminal. It sets up WSL2, puts tgarr inside and opens the browser when it is done.

Download install-tgarr.cmd

macOS

Open the zip and right-click install-tgarr.command → Open. It needs Homebrew; the installer adds Colima and puts tgarr inside. This installer has not yet been run from end to end on a real Mac.

Download install-tgarr-macos.zip

Linux and NAS

One line on Linux:

curl -fsSL https://raw.githubusercontent.com/tgarrpro/tgarr/main/install/install.sh | bash

On Synology, QNAP, Unraid, TrueNAS or CasaOS: two files and docker compose up -d. On a NAS

Television

Android TV, Google TV, Fire TV: this 20 kB app is a frame around the Media Center of the tgarr at home, driven by the remote.

Download tgarr-tv.apk

No account of any kind is needed to begin. It takes about 3 GB of disk and 4 GB of memory to spare, and keeps itself up to date. The full instructions.

QuestionsAsked often

Does it remember where I stopped in an audiobook?

In part. On the Audiobooks shelf the player notes the file and the second every five seconds, in the browser you listen in, and goes back there when you open the shelf again. It is one place - the last file you heard - not one per book, and it does not follow you to another device. For a place kept per book on every device, Audiobookshelf is the tool.

Can it play LibriVox audiobooks?

Yes. The Archive page has an Audiobooks shelf that searches the LibriVox collection of the Internet Archive. Press Get and tgarr fetches the recording - the MP3 files when the item has them - and puts it on the audiobook shelf. No account is needed for that.

How does tgarr tell an audiobook from music?

Not by length. A sound file is an audiobook when it is an .m4b, when it lies in a folder called audiobooks, when it was fetched from the Audiobooks shelf of the Archive or the Usenet page, or when its name, title or album says so (audiobook, unabridged, 有声书, 听书, 评书). Everything else is music.

Where do the lyrics come from?

From the file's own tag when it is a FLAC that carries one. Otherwise tgarr asks lrclib.net, a free lyrics service, and sends it the title, the artist and the length of the track - nothing about you. The answer is kept, so each song is asked for once. Timed lyrics are lit line by line; a click on a line jumps there.

Is there a sleep timer, a speed control or chapters?

No. The player has play, pause, previous, next, shuffle, a bar to seek on, favourites and download. It has no sleep timer, no speed control and no chapter list inside a single .m4b file. A book that came as one file per chapter is played file after file, in order.

Can a child listen without reaching the rest?

Yes. With a PIN set, a browser without it sees only the Media Center, and on its Listen shelf only the sound files a parent ticked. Time rules apply. There each file opens by itself with the browser's own audio controls - it does not go on to the next chapter on its own.