# Nowly Documentation
> Automatically update your Discord status with what you're watching on streaming platforms.

## Documentation

- [Introduction](https://nowly.me/docs/getting-started/introduction): Learn what Nowly is, how Discord Rich Presence works, and how Nowly Host connects supported websites to Discord.
- [Installation](https://nowly.me/docs/getting-started/installation): Install the Nowly extension, enable user scripts, install Nowly Host, open Discord Desktop, and run your first test.
- [Installing Presences](https://nowly.me/docs/getting-started/installing-presences): Install website integrations from the Nowly library and test activity detection on a supported site.
- [Troubleshooting](https://nowly.me/docs/getting-started/troubleshooting): Fix missing Nowly Host, closed Discord Desktop, missing presences, missing activity, unsupported URLs, and permission issues.
- [Prerequisites](https://nowly.me/docs/presence-development/prerequisites): Set up your local environment to develop presences — clone the presences repository and install the CLI.
- [Creating Your First Presence](https://nowly.me/docs/presence-development/creating-your-first-presence): Create a new Nowly presence with the CLI and send your first Discord Rich Presence activity.
- [Presence Structure](https://nowly.me/docs/presence-development/presence-structure): Understand the required folder layout for a Nowly presence.
- [Metadata](https://nowly.me/docs/presence-development/metadata): Document every required and optional field in a Nowly presence metadata.json file.
- [Presence API](https://nowly.me/docs/presence-development/presence-api): Use the Nowly Presence API to update Discord Rich Presence from a website integration.
- [Assets](https://nowly.me/docs/presence-development/assets): Prepare logo, icon, and thumbnail assets for Nowly presences.
- [Settings](https://nowly.me/docs/presence-development/settings): Add typed per-presence settings with boolean, input, select, and slider controls.
- [iFrames](https://nowly.me/docs/advanced-topics/iframes): Handle activity data that lives inside embedded frames.
- [Timestamps](https://nowly.me/docs/advanced-topics/timestamps): Display playback progress in Discord Rich Presence with media timestamps.
- [Localization](https://nowly.me/docs/advanced-topics/localization): Localize presence metadata, features, settings, and strings.
- [Best Practices](https://nowly.me/docs/advanced-topics/best-practices): Build reliable, privacy-friendly, and maintainable Nowly presences.
- [Image Proxy](https://nowly.me/docs/advanced-topics/image-proxy): Use the Nowly image proxy when Discord cannot load a presence image directly from a supported external CDN.
- [Presence Language Packs](https://nowly.me/docs/advanced-topics/presence-language-packs): Add optional, typed translations for Discord activity text.
- [CLI](https://nowly.me/docs/publishing/cli): Use the Nowly CLI to create, build, validate, and test presences locally.
- [Validate and Build](https://nowly.me/docs/publishing/validate-and-build): Validate presence metadata and build presence bundles before publishing.
- [Contribution Guidelines](https://nowly.me/docs/publishing/contribution-guidelines): Follow Nowly contribution expectations for reliable and maintainable presences.

## Changelog

- [1.3.0](https://nowly.me/docs/changelog/1-3-0): Typed presence language packs, global and per-presence Discord activity language controls, and stable 1.0 SDK and CLI releases.
- [1.2.1](https://nowly.me/docs/changelog/1-2-1): Hotfix release — removes dev environment variable leaks from production build and simplifies API configuration.
- [1.2.0](https://nowly.me/docs/changelog/1-2-0): UI/UX overhaul of the extension with a redesigned player, native components, activity badge, snooze & planning, conditional debug panel, and settings reorganization.
- [1.1.0](https://nowly.me/docs/changelog/1-1-0): The first maintenance release for Nowly, focused on update flows, active tracking, uninstall cleanup, docs cleanup, and release polish.
- [1.0.0](https://nowly.me/docs/changelog/1-0-0): The first stable launch of Nowly, covering the browser extension, Nowly Host, public library, and publishing workflow.

## Resources

- [GitHub Repository](https://github.com/nowly-presence/nowly)
- [Discord Rich Presence](https://discord.com/rich-presence)