[Bug]: Import breaks for certain file names #802

New Issue

Closed

opened 2026-04-24 23:22:11 +02:00 by adam · 10 comments

adam commented 2026-04-24 23:22:11 +02:00

Owner

Copy Link

Copy Source

Originally created by @lkiesow on GitHub (Dec 6, 2022).

Describe the issue

Trying to import a new audiobook from a path like /data/audiobooks/Firstname\ Lastname/Bookname, the scanner just fails since audiobookshelf corrupts the filename.

{"timestamp":"2022-12-06 21:31:52","message":"[fileUtils] Recurse files error Error: ENOENT: no such file or directory, scandir '/audiobooks/Firstname/ Lastname/Bookname/'","levelName":"ERROR","level":4}
{"timestamp":"2022-12-06 21:31:52","message":"[fileUtils] Failed to getFileTimestampsWithIno Error: ENOENT: no such file or directory, stat '/audiobooks/Firstname/ Lastname/Bookname'","levelName":"ERROR","level":4}
{"timestamp":"2022-12-06 21:31:52","message":"[Scanner] Library item has no media files \"/audiobooks/Firstname/ Lastname/Bookname\"","levelName":"WARN","level":3}

It seems like audiobookshelf converts the \ which is part of the folder name to / which turns the second part of the folder name into a subfolder. All attempts at importing the files then fail since the path is no longer correct and the files do not exist.

Audiobookshelf version

v2.2.8

How are you running audiobookshelf?

Docker

Originally created by @lkiesow on GitHub (Dec 6, 2022). ### Describe the issue Trying to import a new audiobook from a path like `/data/audiobooks/Firstname\ Lastname/Bookname`, the scanner just fails since audiobookshelf corrupts the filename. ``` {"timestamp":"2022-12-06 21:31:52","message":"[fileUtils] Recurse files error Error: ENOENT: no such file or directory, scandir '/audiobooks/Firstname/ Lastname/Bookname/'","levelName":"ERROR","level":4} {"timestamp":"2022-12-06 21:31:52","message":"[fileUtils] Failed to getFileTimestampsWithIno Error: ENOENT: no such file or directory, stat '/audiobooks/Firstname/ Lastname/Bookname'","levelName":"ERROR","level":4} {"timestamp":"2022-12-06 21:31:52","message":"[Scanner] Library item has no media files \"/audiobooks/Firstname/ Lastname/Bookname\"","levelName":"WARN","level":3} ``` It seems like audiobookshelf converts the `\` which is part of the folder name to `/` which turns the second part of the folder name into a subfolder. All attempts at importing the files then fail since the path is no longer correct and the files do not exist. ### Audiobookshelf version v2.2.8 ### How are you running audiobookshelf? Docker

adam added the bug label 2026-04-24 23:22:11 +02:00

adam closed this issue 2026-04-24 23:22:11 +02:00

adam commented 2026-04-24 23:22:12 +02:00

Author

Owner

Copy Link

Copy Source

@advplyr commented on GitHub (Dec 6, 2022):

Ah yeah this is to update Windows paths that use \. There is probably a better way, I just didn't want Windows paths to be stored in the db.

@advplyr commented on GitHub (Dec 6, 2022): Ah yeah this is to update Windows paths that use `\`. There is probably a better way, I just didn't want Windows paths to be stored in the db.

adam commented 2026-04-24 23:22:13 +02:00

Author

Owner

Copy Link

Copy Source

@lkiesow commented on GitHub (Jan 2, 2023):

Do you know if scandir is always guaranteed to be an absolute path? In that case, it should always start with / on a Unix-like system, and we could sip the replacement in such cases.

@lkiesow commented on GitHub (Jan 2, 2023): Do you know if `scandir` is always guaranteed to be an absolute path? In that case, it should always start with `/` on a Unix-like system, and we could sip the replacement in such cases.

adam commented 2026-04-24 23:22:14 +02:00

Author

Owner

Copy Link

Copy Source

@advplyr commented on GitHub (Jan 2, 2023):

scandir returns both absolute and relative. Where did you enter that file path?

@advplyr commented on GitHub (Jan 2, 2023): scandir returns both absolute and relative. Where did you enter that file path?

adam commented 2026-04-24 23:22:14 +02:00

Author

Owner

Copy Link

Copy Source

@lkiesow commented on GitHub (Jan 4, 2023):

You mean the one with \? The scanner picked that up from the file system.

@lkiesow commented on GitHub (Jan 4, 2023): You mean the one with `\`? The scanner picked that up from the file system.

adam commented 2026-04-24 23:22:14 +02:00

Author

Owner

Copy Link

Copy Source

@lkiesow commented on GitHub (Jan 4, 2023):

Thinking about this for a second… even if it can be a relative path, it should be easy to turn it into an absolute path and then act on that. I'll take a look and will propose a patch soonish.

@lkiesow commented on GitHub (Jan 4, 2023): Thinking about this for a second… even if it can be a relative path, it should be easy to turn it into an absolute path and then act on that. I'll take a look and will propose a patch soonish.

adam commented 2026-04-24 23:22:15 +02:00

Author

Owner

Copy Link

Copy Source

@lkiesow commented on GitHub (Jan 4, 2023):

Unfortunately, replacement like this seems to be all over the project.
Fixing this won't be as easy as I hoped:

❯ grep -rn '\\\\' server --exclude-dir=libs | grep replace
server/scanner/Scanner.js:562:      var fullPath = Path.posix.join(folder.fullPath.replace(/\\/g, '/'), itemDir)
server/scanner/Scanner.js:567:      var altFullPath = Path.posix.join(folder.fullPath.replace(/\\/g, '/'), altDir)
server/scanner/Scanner.js:581:      var fullPath = Path.posix.join(folder.fullPath.replace(/\\/g, '/'), itemDir)
server/Watcher.js:146:    path = path.replace(/\\/g, '/')
server/Watcher.js:157:    var folder = libwatcher.folders.find(fold => path.startsWith(fold.fullPath.replace(/\\/g, '/')))
server/Watcher.js:162:    var folderFullPath = folder.fullPath.replace(/\\/g, '/')
server/Watcher.js:192:      return path.replace(/\\/g, '/').startsWith(dirpath)
server/Watcher.js:197:    var path = path.replace(/\\/g, '/')
server/controllers/PodcastController.js:33:    var podcastPath = payload.path.replace(/\\/g, '/')
server/Server.js:51:      global.ConfigPath = global.ConfigPath.replace(/\\/g, '/')
server/Server.js:52:      global.MetadataPath = global.MetadataPath.replace(/\\/g, '/')
server/utils/ffmpegHelpers.js:8:  // return path.replace(/'/g, '\'\\\'\'')
server/utils/ffmpegHelpers.js:9:  return path.replace(/\\/g, '/').replace(/ /g, '\\ ').replace(/'/g, '\\\'')
server/utils/scandir.js:183:  const folderPath = folder.fullPath.replace(/\\/g, '/')
server/utils/scandir.js:243:  relPath = relPath.replace(/\\/g, '/')
server/utils/scandir.js:333:  relPath = relPath.replace(/\\/g, '/')
server/utils/scandir.js:348:  relPath = relPath.replace(/\\/g, '/')
server/utils/scandir.js:375:  libraryItemPath = libraryItemPath.replace(/\\/g, '/')
server/utils/scandir.js:376:  var folderFullPath = folder.fullPath.replace(/\\/g, '/')
server/utils/index.js:129:  return path.replace(/\\/g, '/').replace(/%/g, '%25').replace(/#/g, '%23')
server/utils/dbMigration.js:90:  srcPath = srcPath.replace(/\\/g, '/')
server/utils/dbMigration.js:91:  basePath = basePath.replace(/\\/g, '/')
server/utils/fileUtils.js:83:  path = path.replace(/\\/g, '/')
server/utils/fileUtils.js:87:    relPathToReplace = relPathToReplace.replace(/\\/g, '/')
server/objects/mediaTypes/Book.js:185:    coverPath = coverPath.replace(/\\/g, '/')
server/objects/mediaTypes/Music.js:107:    coverPath = coverPath.replace(/\\/g, '/')
server/objects/mediaTypes/Video.js:104:    coverPath = coverPath.replace(/\\/g, '/')
server/objects/mediaTypes/Podcast.js:162:    coverPath = coverPath.replace(/\\/g, '/')
server/objects/Library.js:156:    fullPath = fullPath.replace(/\\/g, '/')
server/objects/Library.js:157:    return this.folders.find(folder => fullPath.startsWith(folder.fullPath.replace(/\\/g, '/')))
server/managers/CoverManager.js:176:    coverPath = coverPath.replace(/\\/g, '/')
server/managers/AudioMetadataManager.js:130:      var coverPath = libraryItem.media.coverPath.replace(/\\/g, '/')

@lkiesow commented on GitHub (Jan 4, 2023): Unfortunately, replacement like this seems to be all over the project. Fixing this won't be as easy as I hoped: ``` ❯ grep -rn '\\\\' server --exclude-dir=libs | grep replace server/scanner/Scanner.js:562: var fullPath = Path.posix.join(folder.fullPath.replace(/\\/g, '/'), itemDir) server/scanner/Scanner.js:567: var altFullPath = Path.posix.join(folder.fullPath.replace(/\\/g, '/'), altDir) server/scanner/Scanner.js:581: var fullPath = Path.posix.join(folder.fullPath.replace(/\\/g, '/'), itemDir) server/Watcher.js:146: path = path.replace(/\\/g, '/') server/Watcher.js:157: var folder = libwatcher.folders.find(fold => path.startsWith(fold.fullPath.replace(/\\/g, '/'))) server/Watcher.js:162: var folderFullPath = folder.fullPath.replace(/\\/g, '/') server/Watcher.js:192: return path.replace(/\\/g, '/').startsWith(dirpath) server/Watcher.js:197: var path = path.replace(/\\/g, '/') server/controllers/PodcastController.js:33: var podcastPath = payload.path.replace(/\\/g, '/') server/Server.js:51: global.ConfigPath = global.ConfigPath.replace(/\\/g, '/') server/Server.js:52: global.MetadataPath = global.MetadataPath.replace(/\\/g, '/') server/utils/ffmpegHelpers.js:8: // return path.replace(/'/g, '\'\\\'\'') server/utils/ffmpegHelpers.js:9: return path.replace(/\\/g, '/').replace(/ /g, '\\ ').replace(/'/g, '\\\'') server/utils/scandir.js:183: const folderPath = folder.fullPath.replace(/\\/g, '/') server/utils/scandir.js:243: relPath = relPath.replace(/\\/g, '/') server/utils/scandir.js:333: relPath = relPath.replace(/\\/g, '/') server/utils/scandir.js:348: relPath = relPath.replace(/\\/g, '/') server/utils/scandir.js:375: libraryItemPath = libraryItemPath.replace(/\\/g, '/') server/utils/scandir.js:376: var folderFullPath = folder.fullPath.replace(/\\/g, '/') server/utils/index.js:129: return path.replace(/\\/g, '/').replace(/%/g, '%25').replace(/#/g, '%23') server/utils/dbMigration.js:90: srcPath = srcPath.replace(/\\/g, '/') server/utils/dbMigration.js:91: basePath = basePath.replace(/\\/g, '/') server/utils/fileUtils.js:83: path = path.replace(/\\/g, '/') server/utils/fileUtils.js:87: relPathToReplace = relPathToReplace.replace(/\\/g, '/') server/objects/mediaTypes/Book.js:185: coverPath = coverPath.replace(/\\/g, '/') server/objects/mediaTypes/Music.js:107: coverPath = coverPath.replace(/\\/g, '/') server/objects/mediaTypes/Video.js:104: coverPath = coverPath.replace(/\\/g, '/') server/objects/mediaTypes/Podcast.js:162: coverPath = coverPath.replace(/\\/g, '/') server/objects/Library.js:156: fullPath = fullPath.replace(/\\/g, '/') server/objects/Library.js:157: return this.folders.find(folder => fullPath.startsWith(folder.fullPath.replace(/\\/g, '/'))) server/managers/CoverManager.js:176: coverPath = coverPath.replace(/\\/g, '/') server/managers/AudioMetadataManager.js:130: var coverPath = libraryItem.media.coverPath.replace(/\\/g, '/') ```

adam commented 2026-04-24 23:22:15 +02:00

Author

Owner

Copy Link

Copy Source

@advplyr commented on GitHub (Jan 4, 2023):

It seems strange the scanner is pulling it in with the "\". I think normally this will come in as a space.

I have spaces in my folder paths and they don't come in with a "\".

@advplyr commented on GitHub (Jan 4, 2023): It seems strange the scanner is pulling it in with the "\\". I think normally this will come in as a space. I have spaces in my folder paths and they don't come in with a "\\".

adam commented 2026-04-24 23:22:15 +02:00

Author

Owner

Copy Link

Copy Source

@lkiesow commented on GitHub (Jan 5, 2023):

It seems strange the scanner is pulling it in with the "\". I think normally this will come in as a space.

The \ is part of the file name. It is not an escape character. The watcher is picking up the file name correctly. Using \ as part of a filename is fine on basically all non-windows file systems.

That's why I was looking for a way to just disable the replacement if you are on a Unix-like system.

❯ mkdir '\'; ls -ld '\'
drwxr-xr-x. 2 lars lars 4096 Jan  5 17:45 '\'

@lkiesow commented on GitHub (Jan 5, 2023): > It seems strange the scanner is pulling it in with the "\\". I think normally this will come in as a space. The `\` is part of the file name. It is not an escape character. The watcher is picking up the file name correctly. Using `\` as part of a filename is fine on basically all non-windows file systems. That's why I was looking for a way to just disable the replacement if you are on a Unix-like system. ``` ❯ mkdir '\'; ls -ld '\' drwxr-xr-x. 2 lars lars 4096 Jan 5 17:45 '\' ```

adam commented 2026-04-24 23:22:16 +02:00

Author

Owner

Copy Link

Copy Source

@advplyr commented on GitHub (Jan 6, 2023):

I'm tackling this one now.

@advplyr commented on GitHub (Jan 6, 2023): I'm tackling this one now.

adam commented 2026-04-24 23:22:17 +02:00

Author

Owner

Copy Link

Copy Source

@advplyr commented on GitHub (Jan 8, 2023):

Fixed in v2.2.12

@advplyr commented on GitHub (Jan 8, 2023): Fixed in [v2.2.12](https://github.com/advplyr/audiobookshelf/releases/tag/v2.2.12)

adam referenced this issue 2026-04-25 00:15:37 +02:00

[PR #802] [MERGED] fix getMediaProgress always returning 404 #3428

Sign in to join this conversation.

No Branch/Tag Specified

Branches Tags

master

book_tags_genres_dedupe

episode_download_fallback

Issue-4540-SortBy-StartedDate-and-FinishedDate

episode_meta_tagging

fix_authorize_race_condition

redirect_transcode_requests

progress_updated_sort

fix_ereader_socket_event

fix_change_empty_root_password

fix_podcast_session_track_index

fix_set_token

session_modal_user

localize_durations

fix_oidc_create_user

jwt_auth_refactor

fix_scanner_deleting_single_file_books

fix_mediaprogress_updatedat_2

experimental_next_client

podcast_episode_duration

episode-timestamps-clickable

book_author_secondary_sort_title

podcast_useragents

pathexists_user_access

fix_pathexists_join

book_author_secondary_sort

clean_duplicate_mediaprogress

sanitize_html_description

trix_prevent_attachments

check_path_api_fix

fix_mediaprogress_updatedat

increase_express_json_limit

fix_dockerfile_nunicode

search_episodes

audiobook_tools_update

episode_secondary_sorts

hls_stream_url_update

new_session_track_endpoint

audiobook_tools_enhancements

watcher_rescans_update

player_track_tooltip

fix_exclude_prefixes_crash

socket_item_events

fix_podcast_episode_scanner_promise

new_stats_controller

count_cache_for_userpermissions

parsing-opf-v3

validate_migration_files

fix-quick-match-all-crash

fix-chapter-end-sleep-timer

stringify_sequelize_query

remove-col-ambiguity

fix_next_prev_edit_description

details_trim_whitespace

fix_content_url_basepath

fix_logger_fatal

progress_bar_visibility

batch-edit-populate-map-details

feed_generator_updates

bookmark-modal-updates

migrate-library-item-in-scanner

migrate-new-library-items

migrate-podcasts-new-library-item-2

migrate-podcasts-new-library-item

fix-remove-episode-from-playlist

playback-session-use-new-library-item

refactor-library-item

fix-heatmap-caption

feed-episodes-upsert

share-media-player-media-session-api

remove-old-playlist

remove_old_collection_object

plugin-implementation-demo

feed_migration

refactor-feeds-from-item

fix_remove_authors_no_books

v2.17.3-fk-constraints-migration

migrations-first-upgrade

sqlite_2

feature/nuxt-target-server

waveform

sqlite

playlists

video

v2.35.1

v2.35.0

v2.34.0

v2.33.2

v2.33.1

v2.33.0

v2.32.1

v2.32.0

v2.31.0

v2.30.0

v2.29.0

v2.28.0

v2.27.0

v2.26.3

v2.26.2

v2.26.1

v2.26.0

v2.25.1

v2.25.0

v2.24.0

v2.23.0

v2.22.0

v2.21.0

v2.20.0

v2.19.5

v2.19.4

v2.19.3

v2.19.2

v2.19.1

v2.19.0

v2.18.1

v2.18.0

v2.17.7

v2.17.6

v2.17.5

v2.17.4

v2.17.3

v2.17.2

v2.17.1

v2.17.0

v2.16.2

v2.16.1

v2.16.0

v2.15.1

v2.15.0

v2.14.0

v2.13.4

v2.13.3

v2.13.2

v2.13.1

v2.13.0

v2.12.3

v2.12.2

v2.12.1

v2.12.0

v2.11.0

v2.10.1

v2.10.0

v2.9.0

v2.8.1

v2.8.0

v2.7.2

v2.7.1

v2.7.0

v2.6.0

v2.5.0

v2.4.4

v2.4.3

v2.4.2

v2.4.1

v2.4.0

v2.3.5

v2.3.4

v2.3.3

v2.3.2

v2.3.1

v2.3.0

v2.2.23

v2.2.22

v2.2.21

v2.2.20

v2.2.19

v2.2.18

v2.2.17

v2.2.16

v2.2.15

v2.2.14

v2.2.13

v2.2.12

v2.2.11

v2.2.10

v2.2.9

v2.2.8

v2.2.7

v2.2.6

v2.2.5

v2.2.4

v2.2.3

v2.2.2

v2.2.1

v2.2.0

v2.1.5

v2.1.4

v2.1.3

v2.1.2

v2.1.1

v2.1.0

v2.0.24

v2.0.23

v2.0.22

v2.0.21

v2.0.20

v2.0.19

v2.0.18

v2.0.17

v2.0.16

v2.0.15

v2.0.14

v2.0.13

v2.0.12

v2.0.11

v2.0.10

v2.0.9

v2.0.8

v2.0.7

v2.0.6

v2.0.5

v2.0.4

v2.0.3

v2.0.2

v2.0.1

v1.7.2

v1.7.1

v1.7.0

v1.6.0

v1.5.5

v1.5.0

v1.4.11

v1.4.9

v1.4.7

v1.4.6

v1.4.4

v1.4.2

v1.4.0

v1.4.1

v1.3.4

v1.3.3

v1.3.1

v1.2.8

v1.2.6

v1.2.5

v1.2.4

v1.2.1

v1.1.15

v1.1.14

v1.1.13

v1.1.12

v1.1.11

v1.1.10

v1.1.9

v1.1.8

v1.0.0

0.9.61-beta.0

0.9.61-beta

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

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

adam (Adam Melkus)

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/audiobookshelf#802