URL Scheme
Last Updated:
Sofa uses a custom URL scheme for deeplinking from widgets, shortcuts, and more.
Open Main Sections of the App
sofa:///- This will open Sofasofa:///thepile- This will open The Pilesofa:///theshelf- This will open The Shelf
Deeplink to Lists
The easiest way to get a deeplink for a specific list is to copy it from within the app. Tapping the ••• button in the top right of a list will reveal an option to Copy Deeplink. This will copy the link for that specific list to your clipboard.
A link to open a list will look something like this:
sofa:///list/A3342F8B-B998-4C56-AD60-788B911B6802
Deeplink to Items
The easiest way to get a deeplink for a specific item is to copy it from within the app. Tapping the ••• button for an item will reveal an option to Copy Deeplink. This will copy the link for that specific item to your clipboard.
A link to open an item will look something like this:
sofa:///list/22D2216A-FD55-469C-AD89-44910185397E/item/138227/videoGame/2021-04-24?isCustom=false
Deeplink to Activity
Activity uses year and type parameters to build its custom URL. Tapping the ••• button for an item will reveal multiple options to copy deeplinks.
Copy Deeplink
This will copy the default link for Activity which, when opened, will show all years and types.
sofa:///activity/year/all/type/all
Copy Deeplink with Filters
This will copy a url based on the current filters you have set for Activity. The example below would show all movies logged in 2021.
sofa:///activity/year/2021/type/movies
Deeplinking to Activity Items
You can also copy a deeplink for a specific item in Activity by tapping the ••• for the item and then selecting Copy Deeplink.
Performing Searches
This will open the app to the appropriate search view
- Apps:
sofa:///search/app - Audiobooks:
sofa:///search/audiobook - Books:
sofa:///search/book - Movies & TV Shows:
sofa:///search/movie - Music Albums:
sofa:///search/musicAlbum - Podcasts:
sofa:///search/podcast - Video Games:
sofa:///search/videoGame