Custom Url Scheme on iOS for Deep Linking #554

Open
opened 2026-04-24 23:28:37 +02:00 by adam · 1 comment
Owner

Originally created by @ohare93 on GitHub (May 10, 2023).

Is your feature request related to a problem? Please describe.

I am trying to link Audiobookshelf to the app "One Sec", but cannot do so. One Sec asks me what my intention with an app is before allowing me to open it. It uses Shortcuts to steal the focus whenever I open a configured app, then after doing my thing in One Sec it reopens the original app via deep linking. Usually it it simply accessing the url "[app name]://" which will cause that app to open, but it seems this needs to be explicitly set or something for a TestFlight app.

Describe the solution you'd like

Set a custom Url Scheme (such as "audiobookshelf://") on iOS. Display this in the settings somewhere?

Describe alternatives you've considered

I currently have a workaround by using "itms-beta://" as the url scheme, which opens TestFlight, after which I simply click open on Audiobookshelf. This adds an extra click 😭😅

Additional context

https://developer.apple.com/documentation/xcode/defining-a-custom-url-scheme-for-your-app

Oh and I am hooking it up to One Sec via the "Custom Apps" settings under Customise -> Advanced 👍

Originally created by @ohare93 on GitHub (May 10, 2023). ### Is your feature request related to a problem? Please describe. I am trying to link Audiobookshelf to the app "One Sec", but cannot do so. One Sec asks me what my intention with an app is before allowing me to open it. It uses Shortcuts to steal the focus whenever I open a configured app, then after doing my thing in One Sec it reopens the original app via deep linking. Usually it it simply accessing the url "[app name]://" which will cause that app to open, but it seems this needs to be explicitly set or something for a TestFlight app. ### Describe the solution you'd like Set a custom Url Scheme (such as "audiobookshelf://") on iOS. Display this in the settings somewhere? ### Describe alternatives you've considered I currently have a workaround by using "itms-beta://" as the url scheme, which opens TestFlight, after which I simply click open on Audiobookshelf. This adds an extra click 😭😅 ### Additional context https://developer.apple.com/documentation/xcode/defining-a-custom-url-scheme-for-your-app Oh and I am hooking it up to One Sec via the "Custom Apps" settings under Customise -> Advanced 👍
adam added the enhancement label 2026-04-24 23:28:37 +02:00
Author
Owner

@jdustinlewis commented on GitHub (Feb 16, 2025):

Seems like this is not too difficult to implement with Capacitor (in the professional opinion of a non-developer).
https://capgo.app/blog/integrate-universal-links-capacitor-nextjs/#ios-configuration

@jdustinlewis commented on GitHub (Feb 16, 2025): Seems like this is not too difficult to implement with Capacitor (in the professional opinion of a non-developer). https://capgo.app/blog/integrate-universal-links-capacitor-nextjs/#ios-configuration
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf-app#554