Picklio User Guide
This guide covers playback and the PiP mini window, radiko, the day-by-day YouTube Music timeline, signing in, settings, and what to check when something goes wrong. Installation steps are on the download page.
App interface: Japanese. Japanese labels are shown in parentheses, for example Settings (設定).
Getting started
First, play a song you like and try pressing “PiP”.

Picklio is a player for watching and listening to YouTube, YouTube Music, TVer, ABEMA and radiko in a Mac app, with each site shown as its official page. You can keep it playing in a mini window (PiP) that stays in front of other apps while you work. It has no feature to save videos, music or programmes, and no recording. Other sites are not supported. Once installed, it is ready to use.
The first time you launch it, the Terms of Use screen appears. Read it and press Agree and Use (同意して使う). Because the Terms of Use were revised in 0.8.0, people who used an earlier version are also asked to agree again. Please follow each site’s terms of service and its conditions such as region and viewing plan. You can read the Terms of Use at any time with Terms of Use… (利用規約…) in the app menu.
When you launch it, the player screen opens. The single bar at the top has the following buttons, from left to right.
- Site switcher (YouTube, YouTube Music, TVer, ABEMA, radiko): opens that site in the app. The site you have open is highlighted. When the window is narrow, this becomes a menu for choosing the site.
- Back, Forward, Reload: the same as in a browser.
- Pin the home (ホームの固定, pin): pins one of the filters at the top of the YouTube home (such as “Recently uploaded”). Once pinned, the home is shown with that filter selected when you launch the app or open the home. Choose All (no pin) (すべて(固定しない)) to remove it.
- Timeline (calendar): opens the screen that lists YouTube Music songs and albums day by day (Day-by-day timeline).
- PiP: moves the page that is playing into the mini window (Playback and the PiP mini window).
- URL: shows the address field (you can also use ⌘L).
- …: contains Timeline (タイムライン), Player (プレイヤー; returns to the playback screen), Sign in (ログイン) and Settings… (設定…).
Playback and the PiP mini window
Open a site with “YouTube”, “YouTube Music”, “TVer”, “ABEMA” or “radiko” in the top bar (when the window is narrow, this becomes a menu for choosing the site), then choose and play a video, song or programme just as in an ordinary browser. If you have a link to the page you want, show the address field with “URL” (⌘L), paste it and press Open (開く). The address field closes on its own once the page opens. Press the “×” at the right end of the field to clear the URL in one go.
- Switch to the mini window: press “PiP” while something is playing (Player (プレイヤー) → Open Picture in Picture (ピクチャーインピクチャーを開く) in the menu, or ⌘⇧M, does the same). The main window is hidden and the mini window appears in front of other apps.
- Move and resize: drag the bar without text at the top of the mini window to move it. Drag an edge to change its size.
- Go back: press the red button at the top of the mini window to close it and return to the main window (⌘⇧M also takes you back).
The mini window shows the video on YouTube, TVer and ABEMA; on YouTube Music, the video or the song’s cover art depending on how you are playing; and on radiko, the box for the song on air. When you are listening to music, the Music mini window is square and shows only the cover art, which changes when the song changes. The controls are normally hidden; previous, play/pause and next appear at the bottom only when you move the pointer over it.
The page is moved into the mini window without reloading, so the playback position and your sign-in state stay as they are. If you reopen the app from its Dock icon, the mini window is brought to the front too.
Each page is shown as the site’s official page. Ads also appear just as the site shows them.
Watching TVer
Open the TVer home with “TVer” in the top bar, then choose and play a programme that is available. Links to TVer programmes and episodes can also be opened by pasting them into “URL”.
- Play in the mini window: press “PiP” while it is playing to move the programme’s video and captions into the mini window. You go back the same way as with YouTube.
- Signing in: TVer’s sign-in and settings screens also open inside the app, and you return to TVer when you have signed in.
Programmes cannot be saved or recorded. The first time you play a TVer programme, TVer may show a survey asking for your year of birth, gender and postcode. Please answer it yourself on TVer’s screen. The timeline is for YouTube Music, and live chat and the setting that always shows Japanese captions are for YouTube; they cannot be used on TVer.
Watching ABEMA
Open the ABEMA home with “ABEMA” in the top bar (a site menu when the window is narrow), then choose and play a programme. ABEMA links can also be opened by pasting them into “URL”.
- Play in the mini window: press “PiP” while it is playing to move the programme’s video into the mini window. In the mini window you can play/pause and change its size, and you go back the same way as with YouTube.
Programmes cannot be saved or recorded. Some programmes may not play depending on the programme, region or viewing plan. ABEMA states that some programmes cannot be watched in Safari on the Mac, and Picklio, which displays pages with WebKit, the same engine as Safari, cannot play every programme either. There is no feature that works around DRM, region or viewing-plan restrictions.
Listening to radiko
Liked a song? Use “YouTube Music で探す” to hear it again right away.

Open radiko with “radiko” in the top bar and listen with radiko’s official player. The stations you can listen to are those of the area where radiko determines you are. Picklio never decides or changes the area.
- Listen: choose a station on the radiko page and play it with radiko’s player.
- Find the song that played: under the box for the song on air (title, artist and cover art), Picklio adds a “YouTube Music で探す” (Find on YouTube Music) button. Pressing it takes you to YouTube Music with a search for that song title and artist name. Because you leave the radiko page, radiko playback stops. When no song information is shown, the button does not appear either.
- Play in the mini window: press “PiP” while it is playing to show only the box with the title, artist and cover art of the song on air in the mini window. In the mini window you can play/pause, and you go back the same way as with YouTube.
radiko Premium members sign in on radiko’s screen inside the app, using the sign-in on the radiko page. When you have signed in, you return to radiko.
Changing the area, recording and saving programmes are not possible. What you can listen to and under what conditions, such as Area Free and Time Free, follows radiko’s terms and your own plan. The timeline, live chat and the setting that always shows Japanese captions cannot be used on radiko.
Day-by-day timeline (YouTube Music)
Open it with the calendar button in the top bar (or “…” at the right end of the bar → Timeline (タイムライン)). It lists YouTube Music songs and albums by date along a vertical line. Click a row to open it in the player. Move the pointer over a row to see a larger thumbnail.
- Choose what to list: choose the source with Search results (検索結果), Subscribed artists (登録アーティスト) or Listening history (視聴履歴). You can also switch between Songs & singles (曲・シングル) and Albums (アルバム).
- Load: for search results, enter a search term and press Search (検索). For subscribed artists, press Load subscribed artists (登録アーティストを読み込む). In the list on the left you can choose all subscribed artists or just one artist.
- Choose the order: you can change the order with Newest first (新しい順) or Oldest first (古い順), and the order you choose is used next time too.
Neither search results nor subscribed artists are filtered by date; everything loaded is listed by date. The list appears first, and upload and release dates are filled in afterwards. While they are being checked, “Checking dates” (日付を確認中) is shown at the top, but you can still play and run the next search in the meantime. Information for releases already checked is taken from the cache.
To see more, load the rest with Load more releases (作品をさらに読み込む) at the bottom. Only items within what has been loaded are shown, so not everything released on a given day will necessarily appear. Items whose date is unknown are grouped at the end as Date unknown (日付不明).
Loading subscribed artists uses your YouTube Music sign-in inside the app. If you are not signed in, sign in to YouTube Music from Go to sign-in (ログイン画面へ). For all subscribed artists, the latest 3 releases of each artist are loaded, 5 artists at a time. For older releases, choose a single artist and load.
The timeline is for YouTube Music. The YouTube timeline was removed in 0.8.0.
Listening history
Choose Listening history (視聴履歴) and press Load listening history (視聴履歴を読み込む) to list the songs you listened to on YouTube Music in the order you listened to them, not by release date, grouped into “Today” (今日), “Yesterday” (昨日) and so on. You can choose the order from Most recently played (最近聴いた順) or Earliest played (前に聴いた順). About 200 recently played songs are shown. Loading uses your YouTube Music sign-in inside the app.
Sorting by release date
When Fill in first release dates (作品の初回発売日を補完) is on (it is on by default), the release title and artist name are looked up on MusicBrainz, and releases that match exactly one work with a known first release date are listed on that date. Songs are labelled First release date of the release they appear on (収録作品の初回発売日), and albums First release date of the release (作品の初回発売日). This may differ from the release date of a reissue. Right-click a row and choose Open release date source (発売日の取得元を開く) to open the page that was looked up.
Songs whose release date is unknown are listed by upload date and labelled Shown by upload date (release date unknown) (公開日で表示(発売日不明)). When only the year is known, no date is guessed. To stop looking things up on MusicBrainz, clear the checkbox (it takes effect from the next load).
Signing in
Sign-in data is taken out and used only when the Music timeline reads subscribed artists and listening history.

To sign in, open the site from the screen at “…” at the right end of the bar → Sign in (ログイン), and sign in yourself on the site’s own page. Your sign-in state stays only in Picklio’s in-app browser; sign-ins from Chrome or Safari are not carried over. TVer’s and radiko’s sign-in screens also open inside the app, and you return to the original site when you have signed in.
Only when the timeline loads subscribed artists and listening history, the music.youtube.com cookies from the in-app browser are passed to the helper tool included in the app (ytmusicapi) through a temporary file that only you can read, and the file is deleted afterwards (it may remain if, for example, the app is force-quit). The helper tool only reads song and album information; it does not fetch video or audio. It does not read cookies or passwords from Chrome or any other browser.
Google accounts sometimes restrict signing in from a browser inside an app. Picklio does not work around this restriction by disguising which browser it is.
Site data in the in-app browser (such as sign-in state) can be removed with Delete in-app site data (アプリ内のサイトデータを削除) on the “…” → Sign in (ログイン) screen.
Settings
Open them with Settings… (設定…) in the app menu (⌘,) or with “…” at the right end of the bar → Settings… (設定…).
- Playback (再生): on YouTube and YouTube Music, if you don’t interact for a while, “Continue watching?” (続きを視聴しますか?) appears and playback stops. Picklio keeps playing while you are using the Mac’s keyboard or mouse, including in other apps. With Keep playing without interaction for (操作しないまま再生を続ける時間), you choose how long to wait before stopping when there is no interaction at all (1 to 12 hours, no limit, or YouTube’s default; 2 hours by default). When the time has passed, Picklio pauses playback. To tell whether you have interacted, it checks once a minute only how many seconds have passed since your last input; it does not read which keys you pressed or what you typed. If you turn on Always show Japanese captions on videos that have them (日本語字幕がある動画では、いつも日本語字幕を表示する), Japanese captions are shown every time you open a YouTube video that has Japanese captions from the uploader, even if you have captions turned off (off by default). Videos without Japanese captions are left as YouTube shows them, and it does not switch to automatically generated or auto-translated Japanese captions. The caption on/off and language that YouTube remembers are restored, so captions on other videos are not affected. You can hide them on that video by pressing the captions button while watching. YouTube Music is not covered.
- Timeline storage (タイムラインの保存容量): release information and images loaded in the timeline are cached on this Mac so they show faster next time. The limits are 20 MB for release information and 100 MB for images by default, and you can change them here. When the cache nears its limit, the oldest items that are no longer referenced are cleared first. Clear the checkbox Cache release information and images on this Mac (作品情報・画像をこのMacに一時保存する) to stop caching, and use Clear cache (一時保存を消去) to delete it. Your settings and sign-in state are not removed.
Updates
Once a day the app checks for a new version; when it finds one, it downloads it in the background and verifies its SHA-256, Developer ID signature and Apple notarization. It never restarts while you are using it; the new version is swapped in the next time you quit the app.
- To update right away: choose Check for Updates… (アップデートを確認…) in the app menu, then press Restart and Update Now (今すぐ再起動して更新).
- To stop automatic checks: clear Check for Updates Automatically (アップデートを自動で確認) in the app menu.
- To stop automatic installation: clear Install Updates Automatically (アップデートを自動でインストール), and you will only be notified when a new version is found.
Troubleshooting
Playback stops when I don’t touch my Mac for a while
If you don’t use the Mac at all for the time chosen under Playback (再生) in Settings (2 hours by default), Picklio pauses playback. To keep playing longer, increase the time or choose No limit (制限なし). If you have chosen YouTube’s default (YouTube の標準のまま), playback stops at YouTube’s “Continue watching?” prompt.
Some videos don’t show Japanese captions
Always show Japanese captions on videos that have them (日本語字幕がある動画では、いつも日本語字幕を表示する) only shows Japanese captions added by the uploader. On videos that have only automatically generated captions or YouTube’s auto-translated Japanese captions, it does not switch captions. To see those captions, choose them from the video’s captions button or settings.
Live chat doesn’t appear
YouTube shows live chat and chat replay only in browsers it recognises. To Picklio’s browser it returns only a page saying chat is unavailable (「チャットをご利用いただけません」), so chat cannot be used. When this response comes back, Picklio closes and hides the chat panel and does not show “Chat” or “Chat replay” under the title either. The chat panel may be visible for a moment just after the page opens. If YouTube starts returning chat, it is shown as is.
radiko doesn’t show the stations of the area I want
radiko determines the area you are in by itself. The area cannot be changed in Picklio. Whether you can listen to stations in other areas depends on radiko’s conditions, such as radiko Premium.
“YouTube Music で探す” doesn’t appear on radiko
It does not appear when radiko is not showing information for the song on air (for example between programmes). It is added automatically when the song box appears.
The timeline can’t load subscribed artists or listening history
Check that you are signed in to YouTube Music inside the app. If you are not, sign in from Go to sign-in (ログイン画面へ) and load again. Loading may also fail when the connection is unstable.
The PiP button can’t be pressed
PiP is available only while a YouTube, YouTube Music, TVer, ABEMA or radiko page is open. Open a site from the top bar first, then press it.
The page looks wrong after coming back from the mini window
Press Reload in the top bar to reload the page. If that doesn’t fix it, try changing the window size slightly.
Ads appear
Ads appear just as each site shows them. From 0.8.0, the measures that made ads less likely to appear have been removed.
I can’t find the save list from an earlier version
Because the save feature was removed in 0.8.0, the save list is no longer shown. Files you saved earlier remain where they were saved (~/Downloads/Picklio by default).
“This URL is not supported” (このURLには対応していません) appears
Picklio can open only YouTube, YouTube Music, TVer, ABEMA and radiko links. Links to other sites are not supported.
I can’t sign in with my Google account
Google sometimes restricts signing in from a browser inside an app. Public videos and songs can be played without signing in.
If the problem isn’t solved, please write to info@k386.sub.jp with what happened and the page you had open.
Glossary
- PiP (picture in picture)
- A way of showing the video or song that is playing in a small window that stays in front of other apps.
- Session, cookie
- Information a site uses to remember things such as your sign-in state. In Picklio it stays only inside the in-app browser.
- DRM
- A mechanism applied to paid streaming and similar content to prevent copying. Picklio has no feature that removes DRM or regional restrictions.
- MusicBrainz
- A music database of song and album information that anyone can use. The timeline uses it to check the first release date of releases.
- ytmusicapi
- A tool for reading YouTube Music search results and release information. It is included in the app and used only for the timeline. It does not fetch video or audio.