## How to Install Custom Fonts

- Windows: Right-click the .ttf or .otf file → select "Install" or "Install for all users" → restart your browser.
- macOS: Double-click the .ttf or .otf file → click "Install Font" in Font Book → restart your browser.
- Linux: Copy font files to `~/.local/share/fonts/` → run `fc-cache -fv` → restart your browser.

After installing, refresh this page to see your new fonts. If a font doesn't appear, try the "Try Local Fonts API" button (Chromium browsers only).

Show faces
Detecting…

## Using a specific font via URL

- Param: Append `?font=<Font%20Family%20Name>` to the URL. Spaces and symbols must be URL‑encoded.
- Applies to CSS var: Your site uses `--font-family`; this page also respects it. Example: `?font=Segoe%20UI`.
- Quotes not needed: Do not include quotes in the parameter; they are not required in the CSS variable.
- Installed only: The parameter only works for fonts already installed on your system. It does not download webfonts.

## Compatibility (Ninja apps)

- VDO.Ninja: Generated `?font=` links work with overlays/scenes that honor the `--font-family` variable.
- SocialStream.Ninja: Use the same `?font=` parameter to override the default font in supported widgets.
- Caption.Ninja: Apply `?font=` to caption overlays that support custom font families.

These apps accept a font-family override when the `?font=` parameter is supported in their URLs or embed links. This tool generates properly encoded values for drop‑in use.

## Troubleshooting (Windows)

- Exact family name: Use the font’s family name (not file name). Check Settings → Personalization → Fonts for the proper family label.
- Right install scope: If you installed a font for a different Windows user or via an admin account only, your browser session may not see it. Install “for all users” if needed.
- Supported formats: Browsers use TrueType/OpenType/WOFF. Legacy Type 1 and some bitmap fonts won’t work.
- Weight/style availability: If only Bold is installed, Normal text may fall back. Try a bold sample or install Regular as well.
- Privacy limits: Browsers don’t allow full font enumeration without permission. This page detects from a large known list and optional Local Fonts API.
- Local Fonts API: In Chromium on secure origins (https/localhost), clicking “Try Local Fonts API” can list your exact installed families after permission.

## Manual usage tips

- Force a font: In your CSS: `font-family: "Your Family", Avenir Next, Sora, Roboto, Helvetica, Arial, sans-serif;`
- Test an arbitrary name: Use the search box to try any family; if found, it appears in results with a sample.
- Encoding: Build links like: `?font=Segoe%20UI` (generated links below use proper encoding).
- CJK and script fonts: The sample includes Latin, numerals, and symbols. Replace with script‑specific text to verify shaping.

Note: This page does not install or download fonts; it only detects and previews families already available to your browser.