Originally created by @mark-monteiro on GitHub (Jul 29, 2024).
What was the Problem?
I am unable to download audiobook library items to a custom folder location on my phone's SD card. The download completes successfully, but I get the error 'Download complete but failed to create library item'. It's worth noting that the folder hierarchy for the author/books is created on the file system, and the cover image for the book is also added successfully. However, none of the audio files are added to the filesystem. There is more than enough space on the SD card (almost 100GB free).
NOTE: This ONLY applied to audiobooks. I am able to download and view e-book files successfully without issues
Steps to Reproduce the Issue
Create new custom download location
Download book to selected location
See error described above
What was Expected?
Audio files should download without error
Phone Model
Samsung Galaxy A01
Phone OS
Android 12
Audiobookshelf App Version
Android App - 0.9.74
Installation Source
Google Play Store
Additional Notes
Some other issues that seemed similar or possibly related, but not the same (or closed already):
Originally created by @mark-monteiro on GitHub (Jul 29, 2024).
### What was the Problem?
I am unable to download audiobook library items to a custom folder location on my phone's SD card. The download completes successfully, but I get the error 'Download complete but failed to create library item'. It's worth noting that the folder hierarchy for the author/books is created on the file system, and the cover image for the book is also added successfully. However, none of the audio files are added to the filesystem. There is more than enough space on the SD card (almost 100GB free).
NOTE: This ONLY applied to audiobooks. I am able to download and view e-book files successfully without issues
### Steps to Reproduce the Issue
1. Create new custom download location
2. Download book to selected location
3. See error described above
### What was Expected?
Audio files should download without error
### Phone Model
Samsung Galaxy A01
### Phone OS
Android 12
### Audiobookshelf App Version
Android App - 0.9.74
### Installation Source
Google Play Store
### Additional Notes
Some other issues that seemed similar or possibly related, but not the same (or closed already):
- https://github.com/advplyr/audiobookshelf-app/issues/422
- https://github.com/advplyr/audiobookshelf-app/issues/775
- https://github.com/advplyr/audiobookshelf-app/issues/961
adam
added the bugandroid labels 2026-04-24 23:45:32 +02:00
@PhilipWhiteside commented on GitHub (Oct 4, 2024):
I see there is a download URL in the logs:
10-04 06:44:05.810 22079 22411 D AbsDownloader: Starting library item download with 1 tracks
10-04 06:44:05.810 22079 22411 D AbsDownloader: Audio File Server Path /api/items/li_u2crysmram6n5tt0ya/file/9436100778983439428/download | AF RelPath 1984 (George Orwell).m4a | LocalFolder Path /storage/emulated/0/Audiobook | DestName 1984 (George Orwell).m4a
10-04 06:44:05.811 22079 22411 D DownloadItemPart: Audio File Destination Uri: file:///storage/emulated/0/Android/data/com.audiobookshelf.app/files/Download/1984%20(George%20Orwell).m4a | Final Destination Uri: file:///storage/emulated/0/Audiobook%20/George%20Orwell/1984/1984%20(George%20Orwell).m4a | Download URI https://audiobooks.apps.lan/api/items/li_u2crysmram6n5tt0ya/file/9436100778983439428/download?token=fo.ob.ar
10-04 06:44:05.812 22079 22411 D AbsDownloader: Cover already exists, removing it from /storage/emulated/0/Audiobook /George Orwell/1984/cover-li_u2crysmram6n5tt0ya.jpg
10-04 06:44:05.824 22079 22411 D DownloadItemPart: Audio File Destination Uri: file:///storage/emulated/0/Android/data/com.audiobookshelf.app/files/Download/cover-li_u2crysmram6n5tt0ya.jpg | Final Destination Uri: file:///storage/emulated/0/Audiobook%20/George%20Orwell/1984/cover-li_u2crysmram6n5tt0ya.jpg | Download URI https://audiobooks.apps.lan/api/items/li_u2crysmram6n5tt0ya/cover?token=fo.ob.ar&format=jpeg&raw=1
10-04 06:44:05.833 22079 22411 I DownloadItemManager: Add download item 1984
When I navigate to the cover download URL in a browser I get the cover image displayed. When I do it for the audio download URL I get
Cannot GET /api/items/li_u2crysmram6n5tt0ya/file/9436100778983439428/download
It looks like this might be a server error not app.
@PhilipWhiteside commented on GitHub (Oct 4, 2024):
I see there is a download URL in the logs:
```
10-04 06:44:05.810 22079 22411 D AbsDownloader: Starting library item download with 1 tracks
10-04 06:44:05.810 22079 22411 D AbsDownloader: Audio File Server Path /api/items/li_u2crysmram6n5tt0ya/file/9436100778983439428/download | AF RelPath 1984 (George Orwell).m4a | LocalFolder Path /storage/emulated/0/Audiobook | DestName 1984 (George Orwell).m4a
10-04 06:44:05.811 22079 22411 D DownloadItemPart: Audio File Destination Uri: file:///storage/emulated/0/Android/data/com.audiobookshelf.app/files/Download/1984%20(George%20Orwell).m4a | Final Destination Uri: file:///storage/emulated/0/Audiobook%20/George%20Orwell/1984/1984%20(George%20Orwell).m4a | Download URI https://audiobooks.apps.lan/api/items/li_u2crysmram6n5tt0ya/file/9436100778983439428/download?token=fo.ob.ar
10-04 06:44:05.812 22079 22411 D AbsDownloader: Cover already exists, removing it from /storage/emulated/0/Audiobook /George Orwell/1984/cover-li_u2crysmram6n5tt0ya.jpg
10-04 06:44:05.824 22079 22411 D DownloadItemPart: Audio File Destination Uri: file:///storage/emulated/0/Android/data/com.audiobookshelf.app/files/Download/cover-li_u2crysmram6n5tt0ya.jpg | Final Destination Uri: file:///storage/emulated/0/Audiobook%20/George%20Orwell/1984/cover-li_u2crysmram6n5tt0ya.jpg | Download URI https://audiobooks.apps.lan/api/items/li_u2crysmram6n5tt0ya/cover?token=fo.ob.ar&format=jpeg&raw=1
10-04 06:44:05.833 22079 22411 I DownloadItemManager: Add download item 1984
```
When I navigate to the cover download URL in a browser I get the cover image displayed. When I do it for the audio download URL I get
```
Cannot GET /api/items/li_u2crysmram6n5tt0ya/file/9436100778983439428/download
```
It looks like this might be a server error not app.
+1 I am also unable to complete any downloads from the server using the app.
Same error it claims the download is complete but there are no folders or files anywhere from the book,
@weirdcrap commented on GitHub (Dec 20, 2024):
+1 I am also unable to complete any downloads from the server using the app.
Same error it claims the download is complete but there are no folders or files anywhere from the book,
I had the same error message in the app while downloading audiobooks to a custom local folder. I didn't look into the logs, so I can't confirm that my error is exactly the same. Downloading to "Internal App Storage" still works.
The solution for me was to remove the custom local folder from the Audiobookshelf app. I then added the custom folder to app again, and downloads work now.
Note, I had been using the custom local folder for many months until it stopped working a few weeks ago. This issue seems like a permission issue, so I made sure that "Remove permissions if app is unused" was disabled in the App Info Android menu for the app.
@mjtimblin commented on GitHub (Dec 20, 2024):
I had the same error message in the app while downloading audiobooks to a custom local folder. I didn't look into the logs, so I can't confirm that my error is exactly the same. Downloading to "Internal App Storage" still works.
The solution for me was to remove the custom local folder from the Audiobookshelf app. I then added the custom folder to app again, and downloads work now.
Note, I had been using the custom local folder for many months until it stopped working a few weeks ago. This issue seems like a permission issue, so I made sure that "Remove permissions if app is unused" was disabled in the App Info Android menu for the app.
I had the same error message in the app while downloading audiobooks to a custom local folder. I didn't look into the logs, so I can't confirm that my error is exactly the same. Downloading to "Internal App Storage" still works.
The solution for me was to remove the custom local folder from the Audiobookshelf app. I then added the custom folder to app again, and downloads work now.
Note, I had been using the custom local folder for many months until it stopped working a few weeks ago. This issue seems like a permission issue, so ensured that "Remove permissions if app is unused" was disabled in the App Info Android menu for the app.
I had moved to a new device recently so it may not have properly kept the folder permissions but I recall always having issues with downloads in the past. I usually just ended up moving them to the phone manually. But doing as you suggested seems to have fixed it. I have a separate issue where it seems to think I'm not myself user wise but I think i found a solution for it on github as well.
@weirdcrap commented on GitHub (Dec 20, 2024):
> I had the same error message in the app while downloading audiobooks to a custom local folder. I didn't look into the logs, so I can't confirm that my error is exactly the same. Downloading to "Internal App Storage" still works.
>
> The solution for me was to remove the custom local folder from the Audiobookshelf app. I then added the custom folder to app again, and downloads work now.
>
> Note, I had been using the custom local folder for many months until it stopped working a few weeks ago. This issue seems like a permission issue, so ensured that "Remove permissions if app is unused" was disabled in the App Info Android menu for the app.
I had moved to a new device recently so it may not have properly kept the folder permissions but I recall always having issues with downloads in the past. I usually just ended up moving them to the phone manually. But doing as you suggested seems to have fixed it. I have a separate issue where it seems to think I'm not myself user wise but I think i found a solution for it on github as well.
I have been working on refactoring the Android download logic over the past few months (progress was a bit slow due to life getting in the way). This refactor was primarily focused on cleaning up the framework, and not specifically aimed at fixing any particular issue. However, it is possible that the changes may have resolved this issue as a side effect.
If you get a chance, please try sideloading the APK located at the end of the pull request and let me know if you run into other issues, whether this issue still occurs, or if this issue appears to be resolved. The APK can be downloaded from the "Build APK" workflow at the end of the page by clicking on "View Details", then clicking on "Summary", then downloading the APK. The PR is https://github.com/advplyr/audiobookshelf-app/pull/1587
I am requesting feedback on all of the open Android download issues, so apologies if you receive multiple notifications.
@nichwall commented on GitHub (May 26, 2025):
I have been working on refactoring the Android download logic over the past few months (progress was a bit slow due to life getting in the way). This refactor was primarily focused on cleaning up the framework, and not specifically aimed at fixing any particular issue. However, it is possible that the changes may have resolved this issue as a side effect.
If you get a chance, please try sideloading the APK located at the end of the pull request and let me know if you run into other issues, whether this issue still occurs, or if this issue appears to be resolved. The APK can be downloaded from the "Build APK" workflow at the end of the page by clicking on "View Details", then clicking on "Summary", then downloading the APK. The PR is https://github.com/advplyr/audiobookshelf-app/pull/1587
I am requesting feedback on all of the open Android download issues, so apologies if you receive multiple notifications.


@mark-monteiro commented on GitHub (May 26, 2025):
Sorry, I'm also unable to test this right now. I was originally having this issue on an older version of Android when saving to my SD card, but I lost that phone. My new phone runs a current version of Android and has no SD card. I've been using downloads on that new phone, saving to the internal app storage, without issues.
@mark-monteiro commented on GitHub (May 26, 2025):
Sorry, I'm also unable to test this right now. I was originally having this issue on an older version of Android when saving to my SD card, but I lost that phone. My new phone runs a current version of Android and has no SD card. I've been using downloads on that new phone, saving to the internal app storage, without issues.
On my Android client it appears to be a book specific issue. I have a 10 book series. 8 of them are 1 large mp3 each. The othere two are chapterized mp3s. All of them are stored in the same folder structure
absroot/library/author/series/book/file(s).mp3
Books 2 through 9 of this series download as expected to a folder on my phone storage and result in no error. They can be listened to in the ABS app while on airplane mode and in other media players.
Book 1 downloads, but gives the "Failed to create library item error." The files are on the phone and can be played in any othere media player. However the book cannot be listened to in the ABS app on airplane mode. Book 1 is chapterized (51 mp3s).
Book 1 can be downloaded to Internal Storage with no issues (also works in airplane mode)
@gamendorf commented on GitHub (Aug 23, 2025):
On my Android client it appears to be a book specific issue. I have a 10 book series. 8 of them are 1 large mp3 each. The othere two are chapterized mp3s. All of them are stored in the same folder structure
absroot/library/author/series/book/file(s).mp3
Books 2 through 9 of this series download as expected to a folder on my phone storage and result in no error. They can be listened to in the ABS app while on airplane mode and in other media players.
Book 1 downloads, but gives the "Failed to create library item error." The files are on the phone and can be played in any othere media player. However the book cannot be listened to in the ABS app on airplane mode. Book 1 is chapterized (51 mp3s).
Book 1 can be downloaded to Internal Storage with no issues (also works in airplane mode)
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Originally created by @mark-monteiro on GitHub (Jul 29, 2024).
What was the Problem?
I am unable to download audiobook library items to a custom folder location on my phone's SD card. The download completes successfully, but I get the error 'Download complete but failed to create library item'. It's worth noting that the folder hierarchy for the author/books is created on the file system, and the cover image for the book is also added successfully. However, none of the audio files are added to the filesystem. There is more than enough space on the SD card (almost 100GB free).
NOTE: This ONLY applied to audiobooks. I am able to download and view e-book files successfully without issues
Steps to Reproduce the Issue
What was Expected?
Audio files should download without error
Phone Model
Samsung Galaxy A01
Phone OS
Android 12
Audiobookshelf App Version
Android App - 0.9.74
Installation Source
Google Play Store
Additional Notes
Some other issues that seemed similar or possibly related, but not the same (or closed already):
@PhilipWhiteside commented on GitHub (Oct 4, 2024):
I have the same issue. I also can't download to internal (different error message).
Phone Model
Pixel 5
Phone OS
GrapheneOS, Android 14
Audiobookshelf App Version
Android App - 0.9.76-beta
Installation Source
Google Play Store
Logs
Download to internal
Download to external
@PhilipWhiteside commented on GitHub (Oct 4, 2024):
I see there is a download URL in the logs:
When I navigate to the cover download URL in a browser I get the cover image displayed. When I do it for the audio download URL I get
It looks like this might be a server error not app.
@weirdcrap commented on GitHub (Dec 20, 2024):
+1 I am also unable to complete any downloads from the server using the app.
Same error it claims the download is complete but there are no folders or files anywhere from the book,
@mjtimblin commented on GitHub (Dec 20, 2024):
I had the same error message in the app while downloading audiobooks to a custom local folder. I didn't look into the logs, so I can't confirm that my error is exactly the same. Downloading to "Internal App Storage" still works.
The solution for me was to remove the custom local folder from the Audiobookshelf app. I then added the custom folder to app again, and downloads work now.
Note, I had been using the custom local folder for many months until it stopped working a few weeks ago. This issue seems like a permission issue, so I made sure that "Remove permissions if app is unused" was disabled in the App Info Android menu for the app.
@weirdcrap commented on GitHub (Dec 20, 2024):
I had moved to a new device recently so it may not have properly kept the folder permissions but I recall always having issues with downloads in the past. I usually just ended up moving them to the phone manually. But doing as you suggested seems to have fixed it. I have a separate issue where it seems to think I'm not myself user wise but I think i found a solution for it on github as well.
@nichwall commented on GitHub (May 26, 2025):
I have been working on refactoring the Android download logic over the past few months (progress was a bit slow due to life getting in the way). This refactor was primarily focused on cleaning up the framework, and not specifically aimed at fixing any particular issue. However, it is possible that the changes may have resolved this issue as a side effect.
If you get a chance, please try sideloading the APK located at the end of the pull request and let me know if you run into other issues, whether this issue still occurs, or if this issue appears to be resolved. The APK can be downloaded from the "Build APK" workflow at the end of the page by clicking on "View Details", then clicking on "Summary", then downloading the APK. The PR is https://github.com/advplyr/audiobookshelf-app/pull/1587
I am requesting feedback on all of the open Android download issues, so apologies if you receive multiple notifications.
@PhilipWhiteside commented on GitHub (May 26, 2025):
My specific issue was resolved by folder permissions server side. Not sure about OP.
@mark-monteiro commented on GitHub (May 26, 2025):
Sorry, I'm also unable to test this right now. I was originally having this issue on an older version of Android when saving to my SD card, but I lost that phone. My new phone runs a current version of Android and has no SD card. I've been using downloads on that new phone, saving to the internal app storage, without issues.
@nichwall commented on GitHub (May 26, 2025):
No worries. Thanks for the updates. :)
@gamendorf commented on GitHub (Aug 23, 2025):
On my Android client it appears to be a book specific issue. I have a 10 book series. 8 of them are 1 large mp3 each. The othere two are chapterized mp3s. All of them are stored in the same folder structure
absroot/library/author/series/book/file(s).mp3
Books 2 through 9 of this series download as expected to a folder on my phone storage and result in no error. They can be listened to in the ABS app while on airplane mode and in other media players.
Book 1 downloads, but gives the "Failed to create library item error." The files are on the phone and can be played in any othere media player. However the book cannot be listened to in the ABS app on airplane mode. Book 1 is chapterized (51 mp3s).
Book 1 can be downloaded to Internal Storage with no issues (also works in airplane mode)