General Questions
What is Scaryfolio?
Scaryfolio is a native Apple app for Ghostfolio. It connects to Ghostfolio Cloud or your self-hosted Ghostfolio server so you can view and manage your portfolio from iPhone, iPad, Mac, Apple Watch, and widgets.
Is Scaryfolio an official Ghostfolio app?
No. Scaryfolio is an independent, third-party client for Ghostfolio. It uses Ghostfolio's API but is not developed or maintained by the Ghostfolio team.
Do I need a Ghostfolio account?
Yes. Scaryfolio requires an existing Ghostfolio account on Ghostfolio Cloud or a self-hosted Ghostfolio instance.
Which platforms are supported?
- iPhone/iPad: iOS/iPadOS 17.0 or later
- Mac: macOS 14.0 or later
- Apple Watch: watchOS 10.0 or later, configured from the iPhone app
Connection & Setup
What is my Security Token?
Your Security Token is the token used by Ghostfolio for API access. Scaryfolio sends it to Ghostfolio to create a bearer token, then uses that bearer token for authenticated API requests.
Can I use a self-hosted Ghostfolio instance?
Yes. Choose Self-Hosted in Settings and enter your Ghostfolio server URL. If your server requires proxy authentication, configure custom HTTP headers.
Can I use custom headers?
Yes, for self-hosted instances. You can add multiple custom headers for reverse proxies such as Cloudflare Access, Authelia, or Authentik. Headers are sent with Ghostfolio API requests.
Can I change my Ghostfolio base currency or Zen Mode?
Yes. After connecting, open Settings > Ghostfolio User Settings. You can update Base Currency and Zen Mode from Scaryfolio. These changes are saved back to Ghostfolio.
Why do I see "Portfolio not available"?
Ghostfolio Cloud may require a Ghostfolio Premium plan for portfolio API data. For self-hosted users, this can also happen if the server has no portfolio data, the selected time range has insufficient data, or the server response does not match the API version Scaryfolio expects.
Is my data secure?
Scaryfolio connects directly to Ghostfolio. It does not proxy your portfolio data through a Scaryfolio server. Connection settings and tokens are stored locally on your device, and widget display data is cached in the app group used by Scaryfolio widgets.
Scaryfolio Pro
What does Scaryfolio Pro unlock?
Scaryfolio Pro unlocks write operations and advanced features, including:
- Create, edit, and delete accounts
- Edit account cash balances and delete balance entries
- Add, edit, and delete activities
- Delete holdings and transactions
- Add and remove watchlist items
- Apple Watch credential sync and companion app access
- Home Screen, Lock Screen, Desktop, and Apple Watch widgets
- Portfolio data Shortcuts: Get Portfolio Value, Get Portfolio Gain, Get Portfolio Return, Get Portfolio Currency, and Get Portfolio Currency Symbol
- View options such as net worth, chart mode, excluded accounts, uninvested cash exclusion, symbol-first display, and zero-performance accounts
- Portfolio summary customization, FIRE calculator, tab personalization, and alternate app icons on iPhone and iPad where supported
What is included in the free version?
The free version provides read-only access to portfolio, accounts, holdings, watchlist, and markets where your Ghostfolio API permits it.
How do I purchase Scaryfolio Pro?
- Open Settings.
- Go to the Licence section.
- Select Scaryfolio Pro.
- Complete the App Store purchase.
How do I restore Pro?
- Make sure you are signed in with the Apple ID used for the purchase.
- Open Settings.
- Tap or click Restore Purchases.
Features & Usage
What time ranges are available?
Scaryfolio supports 1D, WTD, MTD, YTD, 1Y, 5Y, and Max. Apple Watch shows a compact subset: 1D, WTD, MTD, YTD, 1Y, and Max.
How often does data refresh?
Core portfolio data refreshes when the app opens or returns to the foreground if the cached data is stale. Watchlist and Markets refresh when opened and after they have been idle for about an hour. You can also manually refresh supported views.
Can I customize the tabs?
Yes, with Scaryfolio Pro. Go to Settings > Personalization to show or hide Portfolio, Accounts, Watchlist, Markets, and the FIRE calculator entry point. At least one main tab must remain enabled. The FIRE calculator entry point is available only when the Portfolio tab is enabled.
Why do performance percentages differ from Ghostfolio or my expectations?
Scaryfolio can use Ghostfolio's investment-based percentage calculation or a period-based calculation. Change this in Settings > View Options with Scaryfolio Pro.
Can I show net worth instead of portfolio value?
Yes, with Scaryfolio Pro. Enable Show Net Worth in Settings > View Options.
Can I customize the portfolio summary metrics?
Yes, with Scaryfolio Pro. Go to Settings > View Options > Portfolio Summary to choose the two lower metrics shown below your portfolio value, such as Range Gain, Range Return, Daily Gain, Daily Return, All-Time Gain, or All-Time Return.
Can I use Scaryfolio with Spotlight, Siri, and Shortcuts?
Yes. Scaryfolio can index account results for Spotlight and exposes App Intents to Shortcuts and Siri. Navigation actions, such as opening Portfolio, Accounts, Watchlist, Markets, or Settings, do not require Pro. Get Portfolio Value, Get Portfolio Gain, Get Portfolio Return, Get Portfolio Currency, and Get Portfolio Currency Symbol require Scaryfolio Pro.
Can I create an end-of-day portfolio notification?
Yes, with Scaryfolio Pro. Create a Shortcuts time-of-day automation that runs Get Portfolio Value, Get Portfolio Gain, Get Portfolio Return, Get Portfolio Currency, or Get Portfolio Currency Symbol, then shows a notification with the results. Notifications may display financial values or currency details outside Scaryfolio, including on the Lock Screen.
How do I edit, delete, or remove items?
Many actions are available from contextual menus. On iPhone and iPad, touch and hold an account, holding, transaction, cash balance entry, or watchlist item. On Mac, right-click or Control-click the item. Choose the available action, such as Edit, Delete, or Remove.
Why is Watchlist unavailable or Premium Required?
Adding and removing watchlist items requires Scaryfolio Pro. Ghostfolio Cloud may also require Ghostfolio Premium for watchlist API access. On self-hosted instances, watchlist availability depends on your Ghostfolio version and configuration.
Why do some values show N/A?
With Scaryfolio Pro, View Options can replace zero change values with N/A and can show N/A for 1D changes on weekends. Check Settings > View Options > Portfolio Summary if this is not the display you expect.
Troubleshooting
What should I do if authentication fails?
- Verify your Security Token.
- For self-hosted instances, verify the URL and HTTPS certificate.
- Check any required custom headers.
- Confirm your Ghostfolio server is reachable from the device.
Why are widgets locked?
Widgets require Scaryfolio Pro. If you have Pro and widgets still appear locked, open Scaryfolio, restore purchases if needed, and refresh portfolio data.
Why does a portfolio data Shortcut require Pro?
Get Portfolio Value, Get Portfolio Gain, Get Portfolio Return, Get Portfolio Currency, and Get Portfolio Currency Symbol are Scaryfolio Pro features. Other Scaryfolio navigation shortcuts do not require Pro.
Why does the Apple Watch app ask me to open iPhone?
The Watch app must receive credentials from the iPhone app. Connect Scaryfolio on iPhone, make sure you have Pro, then use Sync to Apple Watch from Settings if needed.
How do I report a bug or request a feature?
Use the support links in Scaryfolio Settings to open the knowledge base or submit a support ticket.