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

[PR #4384] [MERGED] Enhancement: Improves chapter editing and adds bulk import #4231

New Issue
Closed
opened 2026-04-25 00:18:55 +02:00 by adam · 0 comments
adam commented 2026-04-25 00:18:55 +02:00
Owner
Copy Link
Copy Source

📋 Pull Request Information

Original PR: https://github.com/advplyr/audiobookshelf/pull/4384
Author: @josh-vin
Created: 6/6/2025
Status: ✅ Merged
Merged: 8/14/2025
Merged by: @advplyr

Base: master ← Head: feat/ChaptersEnhancments

📝 Commits (10+)

  • 09397cf Improves chapter editing and adds bulk import
  • 679ffed Alphabetizes strings
  • 54815ea Add a second to bulk chapters so its valid
  • c41bdb9 Moves the lock button and fixes padding on bulk add feature.
  • 9da0be6 Allow clicking on elapsedTime to adjust chapter start
  • 77d7a50 Merge remote-tracking branch 'josh-vin/master' into feat/ChaptersEnhancments
  • 2773c8c Merge remote-tracking branch 'josh-vin/master' into feat/ChaptersEnhancments
  • 3e42383 Fixes UI for Bulk Chapter adder, and changes logic around locking
  • 7dcb9b9 Chapter lookup modal add back button to clear lookup results
  • 8b260c8 Update bulk chapter modal styles, decreased text and button sizes

📊 Changes

4 files changed (+414 additions, -74 deletions)

View changed files

📝 client/pages/audiobook/_id/chapters.vue (+363 -71)
📝 client/strings/en-us.json (+19 -1)
📝 client/strings/es.json (+16 -1)
📝 client/strings/fr.json (+16 -1)

📄 Description

Brief summary

This PR introduces several enhancements to the Chapter Editor, focusing on improving chapter management and user experience. The main features include: Chapter locking functionality, Time increment buttons for precise adjustment of chapter start times, Bulk chapter import, Elapsed time display, Updated UI icons

Which issue is fixed?

This PR addresses several user requests and feedback discussed in the following:

Note: This PR does not implement the full redesign proposed in Discussion #3011, but it addresses several of the core usability concerns.

In-depth Description

What’s included:

  • Chapter Locking:
    Users can now lock chapters (individually or all at once). Locked chapters cannot be edited or deleted until unlocked, reducing accidental modifications during bulk edits or imports.

  • Time Increment Buttons:
    Added -1 and +1 second adjustment buttons for chapter start times, as suggested in the discussion. This makes it easier to quickly align chapters. I did not implement -6 or +6 as the UI was getting crowded.

  • Bulk Chapter Import:
    New import functionality allows users to add multiple chapters at once by pasting or uploading a text list with a recognizable numbering pattern (e.g., "Chapter 1", "Chapter 2", ...). The system automatically parses and adds chapters.

  • Elapsed Time Display:
    While playing a chapter, the editor now displays elapsed time, providing better feedback and helping users with precise editing.

  • UI/UX Improvements:
    Updated various tooltips and icons throughout the Chapter Editor for greater clarity, aiming for a more intuitive interface.

What’s not included (out of scope for this PR):

  • Full UI redesign as proposed in #3011, including split-column layout, draggable chapters, and tabbed right-side panels.
  • “Copy arrow” functionality for transferring chapters between columns. (Part of the redesign)
  • Changes relating to accessibility (screen readers) or new “probe audio files” features.

This PR is focused on targeted, high-impact usability improvements that can be built upon in future redesigns.

I also added some translations that I could more or less verify (I do speak English and Spanish). But wasn't sure about adding more translations than that. Sorry if that's not the proper way to do it!

How have you tested this?

  • Manually tested new features in local development environment (tested on desktop Chrome, Firefox).
  • Verified that:
    • Locked chapters cannot be edited or deleted until unlocked.
    • Time increment buttons correctly adjust start times and update the UI.
    • Bulk import parses chapter lists as expected, including edge cases (missing numbers, extra whitespace, etc.).
    • Elapsed time display updates in real time during playback.
    • UI tooltips and icons render correctly and improve clarity.
  • Confirmed backward compatibility with existing chapter data.

Steps to reproduce/test:

  1. Open an audiobook in the Chapter Editor.
  2. Try locking and unlocking chapters, then attempt to edit them.
  3. Use the time increment buttons on any chapter.
  4. Use the bulk import feature with a sample list.
  5. Play a chapter and observe the elapsed time display.
  6. Hover over tooltips/icons for updated UI elements.

Screenshots

  • Example of bulk import dialog
    BulkChapters
  • Locking/unlocking behavior
    LockingUnlocking
  • New UI and Elapsed time display during playback
    NewButtons
  • Clip showing time increment buttons in action with locking
    LockingFunctionality

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/advplyr/audiobookshelf/pull/4384 **Author:** [@josh-vin](https://github.com/josh-vin) **Created:** 6/6/2025 **Status:** ✅ Merged **Merged:** 8/14/2025 **Merged by:** [@advplyr](https://github.com/advplyr) **Base:** `master` ← **Head:** `feat/ChaptersEnhancments` --- ### 📝 Commits (10+) - [`09397cf`](https://github.com/advplyr/audiobookshelf/commit/09397cf3de9700d39fdbdc026016f8a65994b9d2) Improves chapter editing and adds bulk import - [`679ffed`](https://github.com/advplyr/audiobookshelf/commit/679ffed0eaf11b03c151f7b02badc6cb308f0e3c) Alphabetizes strings - [`54815ea`](https://github.com/advplyr/audiobookshelf/commit/54815ea9c7625ef1cae022a0bceabd6ce06100f4) Add a second to bulk chapters so its valid - [`c41bdb9`](https://github.com/advplyr/audiobookshelf/commit/c41bdb951cd882e80c58109b958d9e37473cb44e) Moves the lock button and fixes padding on bulk add feature. - [`9da0be6`](https://github.com/advplyr/audiobookshelf/commit/9da0be6d36da4ea9be4dab70041ee371fc538854) Allow clicking on elapsedTime to adjust chapter start - [`77d7a50`](https://github.com/advplyr/audiobookshelf/commit/77d7a50b99aa3b64f8a2045626d22fd2441f24f8) Merge remote-tracking branch 'josh-vin/master' into feat/ChaptersEnhancments - [`2773c8c`](https://github.com/advplyr/audiobookshelf/commit/2773c8c4a9a0dd26f410050ec0de970cfa045fc7) Merge remote-tracking branch 'josh-vin/master' into feat/ChaptersEnhancments - [`3e42383`](https://github.com/advplyr/audiobookshelf/commit/3e423839a11154b951b25cadc03cc96774c2c459) Fixes UI for Bulk Chapter adder, and changes logic around locking - [`7dcb9b9`](https://github.com/advplyr/audiobookshelf/commit/7dcb9b98a000fc0674bc4cb4a6fe37c79c411f0c) Chapter lookup modal add back button to clear lookup results - [`8b260c8`](https://github.com/advplyr/audiobookshelf/commit/8b260c8bc6db134f550f0bbb0fbee7b8d2dc46d6) Update bulk chapter modal styles, decreased text and button sizes ### 📊 Changes **4 files changed** (+414 additions, -74 deletions) <details> <summary>View changed files</summary> 📝 `client/pages/audiobook/_id/chapters.vue` (+363 -71) 📝 `client/strings/en-us.json` (+19 -1) 📝 `client/strings/es.json` (+16 -1) 📝 `client/strings/fr.json` (+16 -1) </details> ### 📄 Description ## Brief summary This PR introduces several enhancements to the Chapter Editor, focusing on improving chapter management and user experience. The main features include: Chapter locking functionality, Time increment buttons for precise adjustment of chapter start times, Bulk chapter import, Elapsed time display, Updated UI icons --- ## Which issue is fixed? This PR addresses several user requests and feedback discussed in the following: - [Discussion #3011: Chapter Editor redesign](https://github.com/advplyr/audiobookshelf/discussions/3011) **Note:** This PR does not implement the full redesign proposed in Discussion #3011, but it addresses several of the core usability concerns. --- ## In-depth Description ### What’s included: - **Chapter Locking:** Users can now lock chapters (individually or all at once). Locked chapters cannot be edited or deleted until unlocked, reducing accidental modifications during bulk edits or imports. - **Time Increment Buttons:** Added `-1` and `+1` second adjustment buttons for chapter start times, as suggested in the discussion. This makes it easier to quickly align chapters. I did not implement -6 or +6 as the UI was getting crowded. - **Bulk Chapter Import:** New import functionality allows users to add multiple chapters at once by pasting or uploading a text list with a recognizable numbering pattern (e.g., "Chapter 1", "Chapter 2", ...). The system automatically parses and adds chapters. - **Elapsed Time Display:** While playing a chapter, the editor now displays elapsed time, providing better feedback and helping users with precise editing. - **UI/UX Improvements:** Updated various tooltips and icons throughout the Chapter Editor for greater clarity, aiming for a more intuitive interface. ### What’s not included (out of scope for this PR): - Full UI redesign as proposed in #3011, including split-column layout, draggable chapters, and tabbed right-side panels. - “Copy arrow” functionality for transferring chapters between columns. (Part of the redesign) - Changes relating to accessibility (screen readers) or new “probe audio files” features. This PR is focused on targeted, high-impact usability improvements that can be built upon in future redesigns. I also added some translations that I could more or less verify (I do speak English and Spanish). But wasn't sure about adding more translations than that. Sorry if that's not the proper way to do it! --- ## How have you tested this? - Manually tested new features in local development environment (tested on desktop Chrome, Firefox). - Verified that: - Locked chapters cannot be edited or deleted until unlocked. - Time increment buttons correctly adjust start times and update the UI. - Bulk import parses chapter lists as expected, including edge cases (missing numbers, extra whitespace, etc.). - Elapsed time display updates in real time during playback. - UI tooltips and icons render correctly and improve clarity. - Confirmed backward compatibility with existing chapter data. **Steps to reproduce/test:** 1. Open an audiobook in the Chapter Editor. 2. Try locking and unlocking chapters, then attempt to edit them. 3. Use the time increment buttons on any chapter. 4. Use the bulk import feature with a sample list. 5. Play a chapter and observe the elapsed time display. 6. Hover over tooltips/icons for updated UI elements. --- ## Screenshots - [ ] Example of bulk import dialog ![BulkChapters](https://github.com/user-attachments/assets/979bb4e2-b13c-4053-be14-55e09f42accd) - [ ] Locking/unlocking behavior ![LockingUnlocking](https://github.com/user-attachments/assets/81d33191-ed87-42ff-b995-fc1c9c213e36) - [ ] New UI and Elapsed time display during playback ![NewButtons](https://github.com/user-attachments/assets/a5f40703-f7fc-4e96-9a16-a8b2d338902a) - [ ] Clip showing time increment buttons in action with locking ![LockingFunctionality](https://github.com/user-attachments/assets/60b6f087-b7b1-494f-9c14-ed40268826b5) --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
adam added the pull-request label 2026-04-25 00:18:55 +02:00
adam closed this issue 2026-04-25 00:18:55 +02:00
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 pull-request
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#4231
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?