Scaryfolio widgets let you view portfolio data outside the main app. Widgets require Scaryfolio Pro and an existing connection to Ghostfolio.
Requirements
- Scaryfolio Pro
- Scaryfolio connected to Ghostfolio
- Portfolio data refreshed in the main app
- A supported widget surface on iPhone, iPad, Mac, Lock Screen, or Apple Watch
Available iPhone, iPad, and Mac Widgets
| Widget | Information Displayed | Platforms |
|---|---|---|
| Portfolio | Portfolio value plus two configurable timeframe performance rows. You can choose an account and the top and bottom timeframes. | iPhone, iPad, Mac; Lock Screen circular and rectangular on iPhone where supported |
| Performance | Two configurable performance metrics such as Daily Return, Daily Gain, All-Time Return, or All-Time Gain. You can choose an account. | iPhone, iPad, Mac; Lock Screen circular and rectangular on iPhone where supported |
| Portfolio Chart | Portfolio value, selected-range performance, and a compact chart. You can choose an account and chart time range. | iPhone, iPad, Mac |
| FIRE | Current sustainable monthly withdrawal, projected monthly withdrawal at retirement, and time left until retirement. Tapping the widget opens the FIRE calculator. | iPhone, iPad, Mac |
System Small and System Medium sizes are supported for the Home Screen, iPad, Mac Desktop, and Notification Center surfaces. Lock Screen support depends on iOS and widget family availability.
Available Apple Watch Widgets
| Widget | Information Displayed | Families |
|---|---|---|
| Portfolio Performance | Portfolio value and selected time range performance. | Rectangular, Circular, Corner |
| Amount Change | Compact amount or return change for a selected time range. | Circular |
| Amount Change Ring | Performance change with a ring-style presentation. | Circular |
| Portfolio Ring | Portfolio snapshot with a ring-style presentation. | Circular |
Watch widget time ranges include 1D, WTD, MTD, YTD, 1Y, 5Y, and Max. Watch widget updates depend on cached data, Apple Watch connectivity, and system widget refresh scheduling.
Adding a Widget on iPhone or iPad
- Touch and hold an empty area on the Home Screen.
- Tap the add button.
- Search for Scaryfolio.
- Choose a widget size.
- Tap Add Widget.
- Place the widget and tap Done.
Adding a Lock Screen Widget
- Touch and hold the Lock Screen.
- Tap Customize.
- Select the Lock Screen.
- Tap the widget area.
- Choose Scaryfolio.
- Tap Done.
Adding a Widget on Mac
- Open Notification Center or right-click the Desktop.
- Choose Edit Widgets.
- Search for Scaryfolio.
- Add or drag the widget to your preferred location.
- Click Done.
Widget Configuration
Most widgets can be configured directly from the system widget editor after you add them.
- Account: Portfolio, Performance, and Portfolio Chart widgets can show all accounts or a specific account when account data is available.
- Portfolio timeframes: The Portfolio widget can show two timeframe rows. Options include Today, WTD, MTD, YTD, 1Y, 5Y, and All-Time.
- Performance metrics: The Performance widget can show Daily Gain, Daily Return, All-Time Gain, or All-Time Return.
- Chart range: The Portfolio Chart widget supports WTD, MTD, YTD, 1Y, 5Y, and Max. 1D is not available for chart widget range selection.
- FIRE: The FIRE widget uses the FIRE calculator settings saved in Scaryfolio.
How Widgets Update
Widgets use cached portfolio data written by Scaryfolio. WidgetKit controls when timelines refresh, and Scaryfolio also reloads timelines after relevant app data updates. For the newest data, open Scaryfolio and refresh portfolio data.
On Mac, Scaryfolio uses a background helper login item to refresh widget data when the app is not active. The helper must be allowed in System Settings > General > Login Items & Extensions.
Widget data can be affected by Scaryfolio settings such as Show Net Worth, Exclude Uninvested Cash, Investment-Based Returns, Portfolio Summary metrics, Show N/A options, chart settings, and FIRE settings. After changing these settings, open or refresh Scaryfolio so updated widget data can be cached.
Troubleshooting
Widget Shows Not Connected
- Open Scaryfolio.
- Connect to Ghostfolio in Settings.
- Refresh portfolio data.
Widget Shows Pro Required
- Purchase or restore Scaryfolio Pro.
- Open Scaryfolio after Pro is active.
- Refresh portfolio data so cached widget data includes Pro status.
Widget Data is Outdated
- Open Scaryfolio to refresh data.
- Wait for the system to refresh the widget timeline.
- Remove and re-add the widget if it remains stuck.
Mac Widgets Do Not Refresh in the Background
On Mac, Scaryfolio uses a background helper login item to refresh widget data. If widgets stop updating and the helper does not appear in Activity Monitor, macOS may have a stale login item registration.
- Open Terminal.
- Run:
launchctl bootout gui/$(id -u)/com.bittenapps.scaryfolio.backgroundhelper 2>/dev/null - Open System Settings > General > Login Items & Extensions.
- Disable and then re-enable Scaryfolio.
- Open Scaryfolio again.
After re-enabling it, the helper should appear as Background Helper when it is running, and widgets should refresh again.
Widget Looks Blank or Incomplete
- Confirm Ghostfolio has portfolio data.
- Try a different widget size.
- Open Scaryfolio and refresh the Portfolio tab.
Privacy Note
Widgets can display portfolio values where other people may see them. Remove widgets from visible screens if you do not want financial amounts shown outside the app.