# HTTMELY User Guide

HTTMELY is a local-first macOS reader for HTML and Markdown folders.

Choose a folder from anywhere on your Mac, add it to HTTMELY, and browse the pages in a calm native window.

## What HTTMELY Opens

HTTMELY can open folders that contain:

- `.html`
- `.htm`
- `.md`
- `.markdown`

The folder can be anywhere on your Mac.

## Add A Folder

1. Open HTTMELY.
2. Choose `Places > Add Folder...`.
3. Select a folder that contains HTML or Markdown pages.
4. Use the sidebar place picker to switch to that folder.
5. Select pages from the sidebar list.

HTTMELY stores the folder shortcut locally. It does not move or upload your files.

## Navigate

- Use the sidebar place picker to switch folders.
- Use the sidebar page list to open a page.
- In folder Places, use the sidebar file filter or `View > Folder Files` to show all pages, HTML only, or Markdown only.
- Use the bottom sidebar icons for previous page, next page, contents, and reload.
- Use `View > Contents` to show or hide in-page contents navigation.
- Right-click a page to open it externally or reveal it in Finder.

## Manage Places

Use `Places > Manage Places...` to:

- Add folders.
- Rename how a folder appears in HTTMELY.
- Reorder folders.
- Remove folders from HTTMELY.

Removing a folder from HTTMELY does not delete it from disk.

## Useful Shortcuts

- `Command-[`: previous page
- `Command-]`: next page
- `Command-R`: reload page
- `Command-Option-C`: contents
- `Command-Option-S`: sidebar
- `Command-Option-F`: add folder
- `Command-Option-,`: manage places
- `Command-Option-1...9`: switch places

## Good Folder Shape

```text
My Pages/
  index.html
  overview.html
  notes.md
  archive/
    2026-05-16.html
```

Use `index.html` or `index.md` when you want a clear landing page.