URL Scheme
Last Updated:
Sofa uses a custom URL scheme for deeplinking from widgets, shortcuts, and more.
Subscribe Links for Podcasts
If you’re a podcaster, I built a handy little tool to help you easily create a “Listen On Sofa” button for your podcast.
Open Main Sections of the App
Open Sofa
sofa:///Open Lists
sofa:///listsOpen The Pile
sofa:///thepileOpen Pinned Items
sofa:///pinnedOpen Up Next (Player tab)
sofa:///upnextOpen Logbook
sofa:///logbookOpen Logbook Stats
sofa:///logbook/statsOpen Planner
sofa:///plannerOpen Search
sofa:///searchDeeplink 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-788B911B6802Deeplink 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=falseDeeplink to Logbook
Open the Logbook filtered to a specific year:
sofa:///logbook/year/2025Open the Logbook filtered to a specific category:
sofa:///logbook/category/moviesOpen a specific Logbook item:
sofa:///logbook/item/{itemID}/{itemType}/{dateString}?isCustom=falseYou can also copy a deeplink for a specific item in the Logbook by tapping the ••• for the item and then selecting Copy Deeplink.
Legacy Activity URLs
The old sofa:///activity URLs still work and redirect to the Logbook:
sofa:///activity/year/all/type/all
sofa:///activity/year/2021/type/moviesDeeplink to Planner
Open the Planner:
sofa:///plannerOpen a specific event:
sofa:///planner/event/EVENT_ID_HEREOpen a specific task:
sofa:///planner/task/TASK_ID_HEREOpen a specific note:
sofa:///planner/note/NOTE_ID_HEREDeeplink to Progress Tracking
Open the progress tracking view for a specific item (TV show episode list, book checkpoints, etc.):
sofa:///enjoying/ITEM_ID_HEREUp Next
Opens the global Up Next view.
sofa:///upnextOpens the global Up Next view and starts playing the next episode.
sofa:///upnext/playOpens Up Next view for a specific list
sofa:///upnext/list/LIST_ID_HEREStarts playing an episode from global Up Next queue
sofa:///upnext/play/EPISODE_ID_HEREStarts playing an episode from a specific list’s Up Next queue
sofa:///upnext/play/list/LIST_ID_HERE/item/ITEM_ID_HEREOpens the Up Next view for a specific List and starts playing the next episode
sofa:///upnext/play/list/LIST_ID_HEREOpens an episode from global Up Next queue
sofa:///upnext/EPISODE_ID_HEREOpens an episode from a specific list’s Up Next queue
sofa:///upnext/list/LIST_ID_HERE/item/ITEM_ID_HEREPodcast Subscribe Links
Subscribe to a podcast by iTunes ID:
sofa:///subscribe/itunes{ITUNES_ID}Subscribe to a podcast by RSS feed URL:
sofa:///subscribe/{FEED_URL}Performing Searches
Open the Search tab:
sofa:///searchOpen Search filtered to a specific content type:
sofa:///search/app
sofa:///search/audiobook
sofa:///search/book
sofa:///search/movie
sofa:///search/musicAlbum
sofa:///search/podcast
sofa:///search/videoGameSearch with a query (use %20 for spaces):
sofa:///search?q=inception
sofa:///search/movie?q=dune
sofa:///search/book?q=the%20great%20gatsby