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

[Bug]: PDF Reader is flickering #1509

New Issue
Closed
opened 2026-04-24 23:48:03 +02:00 by adam · 12 comments
adam commented 2026-04-24 23:48:03 +02:00
Owner
Copy Link
Copy Source

Originally created by @vincentscode on GitHub (Nov 2, 2023).

Describe the issue

The PDF reader flickers on each page change, which makes using it rather uncomfortable.
The page number also flickers and the green loading bar is rather distracting.

chrome_snkqSByONM

This does not seem necessary since the page is rendered, then white, then rendered again.
Is the first render lower resolution? Would it be possible to not render a white "frame" in between (and remove the loading bar) to make it less jaring?

Steps to reproduce the issue

  1. Open a PDF ebook
  2. Flip through pages

Audiobookshelf version

v2.5.0

How are you running audiobookshelf?

Docker

Originally created by @vincentscode on GitHub (Nov 2, 2023). ### Describe the issue The PDF reader flickers on each page change, which makes using it rather uncomfortable. The page number also flickers and the green loading bar is rather distracting. ![chrome_snkqSByONM](https://github.com/advplyr/audiobookshelf/assets/26576880/b46bf73f-27aa-4945-836f-59847d062c0e) This does not seem necessary since the page is rendered, then white, then rendered again. Is the first render lower resolution? Would it be possible to not render a white "frame" in between (and remove the loading bar) to make it less jaring? ### Steps to reproduce the issue 1. Open a PDF ebook 2. Flip through pages ### Audiobookshelf version v2.5.0 ### How are you running audiobookshelf? Docker
adam added the bugebooks labels 2026-04-24 23:48:03 +02:00
adam closed this issue 2026-04-24 23:48:03 +02:00
adam commented 2026-04-24 23:48:04 +02:00
Author
Owner
Copy Link
Copy Source

@vincentscode commented on GitHub (Nov 3, 2023):

This might be entirely due to the PDF Viewer Library used which appears to be rather unmaintained.
Perhaps switching to something like https://github.com/TaTo30/VuePDF might resolve the issue.

@vincentscode commented on GitHub (Nov 3, 2023): This might be entirely due to the PDF Viewer Library used which appears to be rather unmaintained. Perhaps switching to something like https://github.com/TaTo30/VuePDF might resolve the issue.
adam commented 2026-04-24 23:48:05 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Nov 3, 2023):

Thanks, the codebase isn't using Vue3 yet

@advplyr commented on GitHub (Nov 3, 2023): Thanks, the codebase isn't using Vue3 yet
adam commented 2026-04-24 23:48:06 +02:00
Author
Owner
Copy Link
Copy Source

@vincentscode commented on GitHub (Nov 3, 2023):

I see, I should have checked.
Are there any plans to migrate to Vue 3 as Vue 2 seems to reach its EOL?

@vincentscode commented on GitHub (Nov 3, 2023): I see, I should have checked. Are there any plans to migrate to Vue 3 as Vue 2 seems to reach its EOL?
adam commented 2026-04-24 23:48:06 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Nov 3, 2023):

Yeah but there is no rush to migrate before the EOL. I want to migrate mostly so we can handle subfolder path support for reverse proxies.

@advplyr commented on GitHub (Nov 3, 2023): Yeah but there is no rush to migrate before the EOL. I want to migrate mostly so we can handle subfolder path support for reverse proxies.
adam commented 2026-04-24 23:48:06 +02:00
Author
Owner
Copy Link
Copy Source

@vincentscode commented on GitHub (Nov 3, 2023):

I see, makes sense. For Vue 2 https://www.npmjs.com/package/pdfvuer looks rather compelling (demo) and has a similar programming interface to what is currently used, though a feature to only show a single page at a time does not seem available.

@vincentscode commented on GitHub (Nov 3, 2023): I see, makes sense. For Vue 2 https://www.npmjs.com/package/pdfvuer looks rather compelling ([demo](https://arkokoley.github.io/pdfvuer/)) and has a similar programming interface to what is currently used, though a feature to only show a single page at a time does not seem available.
adam commented 2026-04-24 23:48:06 +02:00
Author
Owner
Copy Link
Copy Source

@vincentscode commented on GitHub (Nov 10, 2023):

After testing it out for a bit, it seems like pdfvuer would basically be a drop-in replacement without any of the issues. I can create a pull request, however my CSS / styling knowledge is quite limited, so somebody else might need to have a look at that afterwards.

@vincentscode commented on GitHub (Nov 10, 2023): After testing it out for a bit, it seems like pdfvuer would basically be a drop-in replacement without any of the issues. I can create a pull request, however my CSS / styling knowledge is quite limited, so somebody else might need to have a look at that afterwards.
adam commented 2026-04-24 23:48:07 +02:00
Author
Owner
Copy Link
Copy Source

@DownloadableFox commented on GitHub (Feb 23, 2024):

What's the current status on this issue? I am experimenting this bug a lot myself.

Would love to contribute for this issue to be fixed ❤️

@DownloadableFox commented on GitHub (Feb 23, 2024): What's the current status on this issue? I am experimenting this bug a lot myself. Would love to contribute for this issue to be fixed ❤️
adam commented 2026-04-24 23:48:08 +02:00
Author
Owner
Copy Link
Copy Source

@vincentscode commented on GitHub (Feb 23, 2024):

The linked PR is functional. Feel free to test it out and improve upon it, if you notice something that could be better!

@vincentscode commented on GitHub (Feb 23, 2024): The linked PR is functional. Feel free to test it out and improve upon it, if you notice something that could be better!
adam commented 2026-04-24 23:48:08 +02:00
Author
Owner
Copy Link
Copy Source

@kabaga commented on GitHub (Apr 3, 2024):

I am on 2.8.1 installed on Debian 12. Mine doesn't flicker, but after a few pages, the page turned dark and the turn pages become unresponsive.
image

@kabaga commented on GitHub (Apr 3, 2024): I am on 2.8.1 installed on Debian 12. Mine doesn't flicker, but after a few pages, the page turned dark and the turn pages become unresponsive. ![image](https://github.com/advplyr/audiobookshelf/assets/44072579/ea145e36-c323-44cf-aa01-d8cec6da4a1e)
adam commented 2026-04-24 23:48:09 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (May 31, 2024):

The flickering is fixed now so I don't think the other PDF reader library is necessary at this time.

@advplyr commented on GitHub (May 31, 2024): The flickering is fixed now so I don't think the other PDF reader library is necessary at this time.
adam commented 2026-04-24 23:48:09 +02:00
Author
Owner
Copy Link
Copy Source

@vincentscode commented on GitHub (Jun 1, 2024):

Sounds good to me. The landscape of Vue 2 PDF libraries is rather abandoned as a whole unfortunately.

@vincentscode commented on GitHub (Jun 1, 2024): Sounds good to me. The landscape of Vue 2 PDF libraries is rather abandoned as a whole unfortunately.
adam commented 2026-04-24 23:48:10 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Jul 9, 2024):

Fixed in v2.11.0

@advplyr commented on GitHub (Jul 9, 2024): Fixed in [v2.11.0](https://github.com/advplyr/audiobookshelf/releases/tag/v2.11.0)
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 bug ebooks
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#1509
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?