Install Focus
Before you start
- Focus isn’t on the App Store. You install it yourself (“sideloading”) with a free Apple Account.
- Free installs expire after 7 days. Re-install with iloader, or let SideStore refresh it for you.
- Your iPhone needs a passcode, and you need a USB cable for the first setup.
- Download the latest Focus IPA: GitHub Releases → latest (the file named
FocusTimer-<version>-<build>.ipa).
Pick your way
[A] iloader on Windows
on your pc
Check your PC
iloader needs 64-bit Windows on an Intel or AMD processor (Windows on Arm isn’t supported).
on your pc
Install iTunes
So Windows can talk to your iPhone: download it from apple.com (recommended) or the Microsoft Store. Open it once and check it sees your iPhone.
If it doesn’t, uninstall iTunes and “Apple Mobile Device Support”, then install the Apple Devices app from the Microsoft Store instead.
on your pc
Download iloader
Only from github.com/nab138/iloader/releases or iloader.app. Pick
iloader-windows-x64.msiand run the installer.pc + iphone
Plug in your iPhone
Unlock it. Tap Trust on the “Trust This Computer?” pop-up and enter your passcode.
in iloader
Sign in
Open iloader. In the Apple ID panel enter your Apple Account email and password and click Login. Type the 6-digit code from your other Apple device and click Submit.
A different Apple Account than the one on your phone is fine. Security-key sign-in isn’t supported.
in iloader
Select your iPhone
Pick it in the iDevice panel. Not there? Click Refresh Devices.
in iloader
Install Focus
Under Installers click Import IPA and choose the Focus
.ipayou downloaded. Wait for “Sign & Install App” to finish.If iloader says “Maximum certificates reached”, let it revoke the old one and click Continue.
on your iphone
Trust the developer
Open Settings → General → VPN & Device Management, tap your Apple Account under “Developer App”, tap Trust (then Allow & Restart if asked) and enter your passcode.
on your iphone
Turn on Developer Mode
Open Settings → Privacy & Security, scroll to the bottom, turn on Developer Mode and tap Restart. After the restart, confirm with Turn On and enter your passcode.
done
Open Focus
Start a focus block to see the timer in the Dynamic Island.
Want updates without a computer? Set up SideStore.
[B] iloader on Mac
on your mac
Download iloader
Nothing extra to install — macOS already includes what’s needed to talk to your iPhone.
Get iloader from github.com/nab138/iloader/releases or iloader.app: pick
iloader-darwin-universal.dmg(works on Apple silicon and Intel Macs). Open it and drag iloader to Applications.on your mac
Allow it to open
If macOS blocks it, go to System Settings → Privacy & Security and click Open Anyway.
mac + iphone
Plug in your iPhone
Unlock it and tap Trust on the phone (and on the Mac if asked). No prompt? Open Finder, then unplug and re-plug the phone.
in iloader
Sign in
Open iloader. In the Apple ID panel enter your Apple Account email and password and click Login. Type the 6-digit code from your other Apple device and click Submit.
A different Apple Account than the one on your phone is fine. Security-key sign-in isn’t supported.
in iloader
Select your iPhone
Pick it in the iDevice panel. Not there? Click Refresh Devices.
in iloader
Install Focus
Under Installers click Import IPA and choose the Focus
.ipayou downloaded. Wait for “Sign & Install App” to finish.If iloader says “Maximum certificates reached”, let it revoke the old one and click Continue.
on your iphone
Trust the developer
Open Settings → General → VPN & Device Management, tap your Apple Account under “Developer App”, tap Trust (then Allow & Restart if asked) and enter your passcode.
on your iphone
Turn on Developer Mode
Open Settings → Privacy & Security, scroll to the bottom, turn on Developer Mode and tap Restart. After the restart, confirm with Turn On and enter your passcode.
done
Open Focus
Start a focus block to see the timer in the Dynamic Island.
Want updates without a computer? Set up SideStore.
[C] SideStore: one-tap updates on the phone
on your iphone
Install LocalDevVPN
Get it from the App Store. Open it, tap connect and allow the VPN configuration.
SideStore needs it (and Wi-Fi) switched on whenever it installs, updates or refreshes apps.
on your computer
Set up iloader
Do steps 1–6 of path A (Windows) or 1–5 of path B (Mac): install iloader, plug in your phone, sign in and select your iPhone. Then come back here.
in iloader
Install SideStore
Under Installers choose SideStore (Stable). iloader downloads SideStore, installs it and places the pairing file for you.
on your iphone
Trust it & turn on Developer Mode
Settings → General → VPN & Device Management: tap your Apple Account, tap Trust.
Settings → Privacy & Security → Developer Mode: turn it on, restart, then confirm with Turn On.
on your iphone
Open SideStore
Connect LocalDevVPN, open SideStore and sign in with the same Apple Account.
in sidestore
Refresh SideStore once
Go to My Apps and tap the 7 DAYS button next to SideStore (tap Yes or Refresh Now if asked). SideStore may jump to the Home Screen — that’s normal.
in sidestore
Add the Focus source
Open the Sources tab, tap +, paste this URL and tap Done:
https://github.com/notanlee/focus-timer/releases/latest/download/source.jsonAlready have Focus installed? Open Focus → Settings → updates → add to sidestore instead.
in sidestore
Install Focus
Open the Focus source and install it. When SideStore asks about App Extensions, choose Keep App Extensions (Register App ID for Each Extension) so the Dynamic Island and widgets keep working.
done
That’s it
SideStore now refreshes Focus in the background and shows an Update button when a new build is out.
Updating Focus
- Focus checks for new builds by itself. When one is out you’ll see
> update availableat the top of the app and in Settings → updates. - iloader: download the new IPA from Releases on your computer, then use Import IPA again. Install over the old version (don’t delete it first) so your local settings stay; tasks are also backed up by sync.
- SideStore: open My Apps and tap Update next to Focus.
Troubleshooting
iloader can’t find my iPhone
“Untrusted Developer” when opening Focus
“Unable to Verify App”
Focus stopped opening after a week
“Maximum number of apps” / not enough App IDs
No timer in the Dynamic Island / no widget
SideStore errors about the VPN, Wi-Fi or pairing file
Need help?
- GitHub: github.com/notanlee/focus-timer/issues
- Discord:
notanlee - TikTok: @notanlee1