starred/audiobookshelf
1
0
Fork 0
mirror of https://github.com/advplyr/audiobookshelf.git synced 2026-05-30 23:40:40 +02:00
Code Issues 1.0k Packages Projects Releases 10 Wiki Activity

[Enhancement]: A method for Tracking activity of the Download of Audiobooks (by user) #2864

New Issue
Open
opened 2026-04-25 00:11:21 +02:00 by adam · 2 comments
adam commented 2026-04-25 00:11:21 +02:00
Owner
Copy Link
Copy Source

Originally created by @epipenRX on GitHub (Jun 30, 2025).

Type of Enhancement

Web Interface/Frontend

Describe the Feature/Enhancement

Currently when looking at user activity, it seems if users are downloading books and listening to them on another application there is no method of tracking which books they have downloaded. It would be nice if there were a method implemented to track/log the books that users are downloading.

An extended version of this request would indicate which books users download and listen to via abs, and which they download but there is no indication they have listened to the books using ABS.

There could also be a manual checkbox to indicate that a book which the user manually downloaded was read/completed so that they can track their reading progress

Why would this be helpful?

It would be helpful to have this data to know how users are using ABS in order to determine if users are active, as if they download a book and listen to it, very little information is recorded about their activity and information about media usage in the library.

It is not nessisarily unusual for a user to download a book to a directory on their phone that is synced with another audiobook app. the listener may never listen to a book in abs. so it might also be good for there to be a checkbox for a user to manually indicate they have finished the book in some way. this would be a good way for the user and the server admin to track their reading progress.

Future Implementation (Screenshot)

i guess it could appear under user activity and just indicate users last activity if it was "downloaded xyz book" and maybe "has listened in abs" could be some kind of flag on the data.

maybe instead of "listening sessions" in the settings menu it could say "user activity" to be more generic but show

  • listening sessions
  • download activity
    or maybe there could be a download activity tab as well... just brainstorming here

clicking settings > users > could show

  • listening stats
  • saved media progress
  • download activity (specifically indicating when and what a user has successfully downloaded an entire book deliberately (as opposed to having downloaded it all by subsequently streaming 100% of it)

Audiobookshelf Server Version

2.25.1

Current Implementation (Screenshot)

settings -> users -> activity column (vs last seen column)
settings -> users -> click on user -> listening states

  • view all
  • saved media progress

Was wondering why some users show so little activity when those same users tell me personally how much they've used the ABS server and about the books they've been listening to. I would find out they had gone through and downloaded a series, or several books to their phone/computer and listened to them locally via other apps, which is fine, but i had thought they were using the server very little, or not at all prior to that.

Originally created by @epipenRX on GitHub (Jun 30, 2025). ### Type of Enhancement Web Interface/Frontend ### Describe the Feature/Enhancement Currently when looking at user activity, it seems if users are downloading books and listening to them on another application there is no method of tracking which books they have downloaded. It would be nice if there were a method implemented to track/log the books that users are downloading. An extended version of this request would indicate which books users download and listen to via abs, and which they download but there is no indication they have listened to the books using ABS. There could also be a manual checkbox to indicate that a book which the user manually downloaded was read/completed so that they can track their reading progress ### Why would this be helpful? It would be helpful to have this data to know how users are using ABS in order to determine if users are active, as if they download a book and listen to it, very little information is recorded about their activity and information about media usage in the library. It is not nessisarily unusual for a user to download a book to a directory on their phone that is synced with another audiobook app. the listener may never listen to a book in abs. so it might also be good for there to be a checkbox for a user to manually indicate they have finished the book in some way. this would be a good way for the user and the server admin to track their reading progress. ### Future Implementation (Screenshot) i guess it could appear under user activity and just indicate users last activity if it was "downloaded xyz book" and maybe "has listened in abs" could be some kind of flag on the data. maybe instead of "listening sessions" in the settings menu it could say "user activity" to be more generic but show - listening sessions - download activity or maybe there could be a download activity tab as well... just brainstorming here clicking settings > users > <click on specfic user> could show - listening stats - saved media progress - download activity (specifically indicating when and what a user has successfully downloaded an entire book deliberately (as opposed to having downloaded it all by subsequently streaming 100% of it) ### Audiobookshelf Server Version 2.25.1 ### Current Implementation (Screenshot) settings -> users -> activity column (vs last seen column) settings -> users -> click on user -> listening states - view all - saved media progress Was wondering why some users show so little activity when those same users tell me personally how much they've used the ABS server and about the books they've been listening to. I would find out they had gone through and downloaded a series, or several books to their phone/computer and listened to them locally via other apps, which is fine, but i had thought they were using the server very little, or not at all prior to that.
adam added the enhancement label 2026-04-25 00:11:21 +02:00
adam commented 2026-04-25 00:11:21 +02:00
Author
Owner
Copy Link
Copy Source

@Vito0912 commented on GitHub (Jun 30, 2025):

Just a general note if that gets implemented or not. There is no guarantee that this will be logged correctly because of third-party apps. It can also happen the other way around.
For example, Plappa always triggers a download. So, any time a user listens, it would show up as a download.

You can already see in the logs if a user has downloaded content. You could use a regex to watch the logs and send a webhook or something similar for now, or just search the logs by hand. Ik it's not ideal.

so it might also be good for there to be a checkbox for a user to manually indicate they have finished the book in some way. this would be a good way for the user and the server admin to track their reading progress.

Already possible

Also maybe in a future the activity will be updated. So anytime a user connects to the server in any way the last seen will be updated. This is currently a PR and there is no guarantee that it gets merged though.

@Vito0912 commented on GitHub (Jun 30, 2025): Just a general note if that gets implemented or not. There is no guarantee that this will be logged correctly because of third-party apps. It can also happen the other way around. For example, Plappa always triggers a download. So, any time a user listens, it would show up as a download. You can already see in the logs if a user has downloaded content. You could use a regex to watch the logs and send a webhook or something similar for now, or just search the logs by hand. Ik it's not ideal. > so it might also be good for there to be a checkbox for a user to manually indicate they have finished the book in some way. this would be a good way for the user and the server admin to track their reading progress. Already possible --- Also maybe in a future the activity will be updated. So anytime a user connects to the server in any way the last seen will be updated. This is currently a PR and there is no guarantee that it gets merged though.
adam commented 2026-04-25 00:11:22 +02:00
Author
Owner
Copy Link
Copy Source

@epipenRX commented on GitHub (Jun 30, 2025):

Just a general note if that gets implemented or not. There is no guarantee that this will be logged correctly because of third-party apps. It can also happen the other way around. For example, Plappa always triggers a download. So, any time a user listens, it would show up as a download.

You can already see in the logs if a user has downloaded content. You could use a regex to watch the logs and send a webhook or something similar for now, or just search the logs by hand. Ik it's not ideal.

so it might also be good for there to be a checkbox for a user to manually indicate they have finished the book in some way. this would be a good way for the user and the server admin to track their reading progress.

Already possible

Also maybe in a future the activity will be updated. So anytime a user connects to the server in any way the last seen will be updated. This is currently a PR and there is no guarantee that it gets merged though.

The information being available in the logs is a somewhat fair point, which is why i added it as a "web ui" enhancement request specifically

To your point about "that's how plappa works, by initiating a download"

  • i suppose, with respect to "logging correctly in the GUI" that would mean that plappa is using an API to 'hit the same download button via API', so there would presumably have to be a separate API marker for users manually clicking and downloading if the feature was implemented, in order for it to be logged as user activity correctly.

I appreciate your quick and well thought out response though. I hope that i have done a well enough job of articulating the request that if it does get implemented, i have shown a good reason/usecase and implementation strategy.

Thank you again.

@epipenRX commented on GitHub (Jun 30, 2025): > Just a general note if that gets implemented or not. There is no guarantee that this will be logged correctly because of third-party apps. It can also happen the other way around. For example, Plappa always triggers a download. So, any time a user listens, it would show up as a download. > > You can already see in the logs if a user has downloaded content. You could use a regex to watch the logs and send a webhook or something similar for now, or just search the logs by hand. Ik it's not ideal. > > > so it might also be good for there to be a checkbox for a user to manually indicate they have finished the book in some way. this would be a good way for the user and the server admin to track their reading progress. > > Already possible > > Also maybe in a future the activity will be updated. So anytime a user connects to the server in any way the last seen will be updated. This is currently a PR and there is no guarantee that it gets merged though. The information being available in the logs is a somewhat fair point, which is why i added it as a "web ui" enhancement request specifically To your point about "that's how plappa works, by initiating a download" - i suppose, with respect to "logging correctly in the GUI" that would mean that plappa is using an API to 'hit the same download button via API', so there would presumably have to be a separate API marker for users manually clicking and downloading if the feature was implemented, in order for it to be logged as user activity correctly. I appreciate your quick and well thought out response though. I hope that i have done a well enough job of articulating the request that if it does get implemented, i have shown a good reason/usecase and implementation strategy. Thank you again.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
authentication
backlog
bug
chapter editor
config-issue
ebooks
encoding/embedding
enhancement
help wanted
listening sessions & progress
planned
possible plugin
progress sync
pull-request
Mirrored from GitHub Pull Request
 sorting/filtering/searching
unable to reproduce
upload
users & permissions
waiting
No Label enhancement
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
adam (Adam Melkus)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#2864
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?