# Floppy for Mac

Floppy for Mac is a free menu bar app that turns any file on your Mac into a short fpy.sh link. It also takes screenshots you can share with a link or copy, annotate and pin on top of your windows, records the screen (trim it, save it as a GIF), converts or compresses files before you send them, and opens Markdown files as documents. This guide covers setup, sharing, screenshots (annotate and pin), the Library of your screenshots and shared files (spaces, Upload and Analytics), screen recordings (trim and GIF), downloading a post, formats, reading Markdown, a shared file's stats and settings, teams, notifications, updates, settings and fixes.

- Download: https://fpy.sh/mac (free, macOS 14 Sonoma or later, Apple silicon and Intel)
- Open Floppy from anywhere: `⌃⌥⌘F`
- This guide as plain Markdown: https://fpy.sh/docs/mac.md

## Set up

1. Download Floppy.dmg from https://fpy.sh/mac, open it and drag Floppy into Applications.
2. Open Floppy. A floppy appears in your menu bar, and a welcome window walks you through the rest.
3. Sign in with Google. If you have no Floppy account, this creates a free one.
4. Turn on the right-click item. In Floppy's Settings (`⌘,`, or the gear in the popover), choose **Sharing** and click **System Settings ↗** next to **Right-click in Finder**, then turn on Floppy under **Finder**.
5. Leave **Launch at login** on.

**Can't see the floppy?** On a full menu bar the notch can hide it. Press `⌃⌥⌘F` to open Floppy, or ⌘-drag other menu bar icons to make room.

## Share a file

However you share, the link is copied as soon as it exists and the upload continues in the background.

| Where | How |
| --- | --- |
| Menu bar | Drop files on the floppy. Drag toward the top right of the screen and a bigger drop shelf slides out. |
| Finder | Right-click files, then **Share via Floppy**. In a team, it offers **Personal** or your team, with your default first. |
| Finder's Share menu | **Share › Floppy**. It works even when the right-click item is off. |
| The popover | Click the floppy, then drop files on it or click **Choose…**. |
| Widgets | **Share** shares files, the clipboard or your latest screenshot. **Your files** lists your latest links and their views. |

- **Several files make one link.** Share up to 500 files, or a folder, together. Apps and packages have to be zipped first.
- **Uploads survive sleep.** They finish with the popover closed, and pick up where they stopped after sleep or a dropped connection.
- **Set the link while it uploads.** Click **Settings ↗** on the upload to add a password, an expiry or a note, or to turn downloads off. **Cancel and delete** stops the upload and deletes the link.
- **The rest is on the web.** Folders, bulk changes and full page-by-page analytics are at https://fpy.sh/app.

## Take a screenshot

Press `⇧⌘4` and drag an area, or press Space and click a window. `⇧⌘3` captures the display under the mouse. The same captures are in the menu bar icon's right-click menu, and the Share widget's **Screenshot** button takes an area.

- **While you select,** the screen holds still. The size shows next to the cursor, with a magnifier. `⇧` keeps the drag to one direction, `⌥` grows it from the centre, holding Space moves it, and `Esc` cancels.
- **The screenshot lands on a card** at the bottom left. The card is the picture, with no text. On hover the picture blurs and the controls show inside it: **Share link** (a fpy.sh link, copied while the picture uploads) and **Copy** (the picture) in the middle, the pencil (annotate) top left, ✕ top right, the pin bottom left and save bottom right. ⌥-click save to show the file in Finder. Drag the card into a message to drop the PNG. The card has no keyboard shortcuts, so typing stays in your app.
- **A strip along the bottom** of the card is its only text: the link while it uploads, then **Copied ✓**; on hover the views, the expiry and delete (hold it). After Copy it says **Picture copied ✓** for a moment. Once shared, the middle buttons are **Copy link** and **Copy**.
- **Nothing uploads** until you click Share link. The card stays until you close it with ✕; ⌥-click ✕ closes every card.
- **Where it's saved:** in `~/Floppy`, one folder per month (`2026-11`), named the Mac's way. Nothing goes to the Desktop. Captures are kept until you delete them. **Show Screenshots Folder**, in the right-click menu, opens `~/Floppy`.

**To use ⇧⌘3 and ⇧⌘4,** turn off the Mac's own two shortcuts: Floppy's **Settings › Shortcuts › Keyboard ↗**, then in **Keyboard Shortcuts… › Screenshots** turn off **Save picture of screen as a file** and **Save picture of selected area as a file**. Until then Floppy uses `⌃⇧4` and `⌃⇧3`. If another screenshot app also uses `⇧⌘4`, turn its shortcut off. `⇧⌘5` stays the Mac's.

macOS asks once for **Screen Recording**. Floppy only looks at the screen when you take a screenshot or record.

## Annotate a screenshot

Click the pencil on the screenshot's card, choose **Annotate Last Screenshot** in the menu bar icon's right-click menu, or double-click a pin. The editor opens with the screenshot between two bars:

- **On top**, three groups: crop, then Select and the drawing tools, then the colour, the line width (3, 5 or 8 pt) and the fill. The colour button opens a list of eight: blue, red, yellow, black, white, green, orange and purple.
- **At the bottom:** Undo, Redo and the zoom menu (50%, 100%, 200%, Fit) on the left, **Drag me** in the middle, and **Copy**, **Pin**, **Save as…** and **Done** on the right. Drag **Drag me** into any app to drop the finished picture there.

| Tool | Key | What it does |
| --- | --- | --- |
| Select | `V` or `Esc` | Move, resize, or delete (`⌫`) a shape. Arrow keys nudge it 1 point, `⇧` 10 |
| Crop | `C` | Drag the edges, `Enter` applies, `Esc` cancels. The original is kept |
| Rectangle | `R` | `F` switches outline and filled. `⇧` for a square |
| Ellipse | `O` | `⇧` for a circle |
| Line | `L` | `⇧` snaps to 45° |
| Arrow | `A` | A line with a swept-back head sized to its width. `⇧` snaps to 45° |
| Pencil | `P` | Draws freehand |
| Highlighter | `H` | Drag a rectangle. The colour is laid over the picture like a marker, so text under it stays readable |
| Text | `T` | Click, type, click away. Double-click to edit again |
| Blur | `B` | Pixelates, then blurs the area |
| Number | `N` | Each click places the next number. Deleting one renumbers the rest |

- **Move a shape without switching to Select:** with the Rect, Ellipse, Line, Arrow, Highlighter or Blur tool, press on an arrow, line, outline, pencil stroke, text or number and drag it. A blur, a highlight or a filled shape moves that way only while it's selected, as it is right after you draw it, so you can still draw on top of one.
- **A thin edge keeps markup readable.** Arrows, lines, boxes, ellipses, pencil strokes and numbers get a thin contrasting edge: dark around yellow and white, white around the other colours. Text, blur and highlights don't.
- **Keys:** `⌘Z` and `⇧⌘Z` undo and redo. Pinch, `⌘+`, `⌘−` and `⌘0` (fit) zoom; hold Space and drag to pan. `⌘C` copies the annotated picture, `⌘S` is Done and `⌘P` pins it. Floppy remembers the last colour, width and fill.
- **Done** saves the PNG under the same name in the same places, and the card or pin shows it. Closing without Done asks **Keep your changes?** when there are any.
- **Already shared?** Done also replaces the file behind the same fpy.sh link. The card says **Updating fpy.sh/k3x9…**, then **Same link, new picture ✓**. This works with the card gone: Floppy remembers each screenshot's link. If the replace can't finish (offline, say), press Done again later.
- **Blur is burned into the PNG.** The pixels under it are not in the file you save or share. The untouched original and your shapes stay next to the screenshot in Floppy's folder, so you can edit them again; neither is uploaded.

## Pin a screenshot

Click the pin on the screenshot's card, choose **Pin Last Screenshot** in the right-click menu, or press `⌘P` in the editor. The picture floats above every window, on every Space and over full-screen apps, where you took it, up to 60% of the screen.

- **Move** it by dragging. **Resize** it with the corner handle, a pinch, `⌘`-scroll, or `⌘+` and `⌘−`; `⌘0` is 100%. The shape is kept and the size shows as a percent.
- **On hover:** close, copy the picture, **Share link** (or **Copy link** once shared) and an opacity slider from 30% to 100%.
- **Double-click** opens the editor; Done updates the pin. `Esc` or `⌘W` closes the pin you last clicked. Pins close when Floppy quits, and clicks don't pass through them.

## The Library: every screenshot and shared file

Click Floppy's icon in the Dock, choose **Library** in the menu bar icon's right-click menu (All Screenshots before Floppy for Mac 1.13.0), or click the grid button at the top of the popover. The Library is one list by month, newest first. It mixes every screenshot, recording and GIF in Floppy's folder with the files you shared: the 200 newest links fpy.sh has for your account, your own and your teams'. A capture you shared shows once, as the capture, with its link.

At the top of the sidebar (Floppy for Mac 1.16.0 or later): the space switcher, once your account has a team, then **Upload** and **Analytics**. Each is below.

Captures need no account. Signed out, a line above the list offers to sign in; your shared files join the list once you do.

### The sidebar

One row is selected at a time, and each shows its icon and how many things it keeps. `⌥↑` and `⌥↓` move through the rows.

| Row | What the list keeps |
| --- | --- |
| **All** | Everything |
| **Screenshots** | Screenshots |
| **Recordings** | Screen recordings and GIFs |
| **Shared files** | The files you shared that aren't captures |
| **With a link** | Shared files, and captures you shared. It shows once something has a link |
| **Places** | What was shared in **Personal** or in one team. Shown when your links are in two places or more and your account has no team; with a team, the space switcher takes its place |
| **Apps** | The captures taken in one app. The six apps you captured most, each with its icon (its initials when the app isn't on this Mac); **More** lists the rest. A downloaded post is listed under its site, with the site's mark: YouTube, Instagram, Pinterest, TikTok or X |
| **File types** | Shared files of one kind: **Videos**, **Zips**, **Images**, **PDFs**, **Audio** or **Documents**. Shown when your shared files are of two kinds or more |

**Settings**, at the foot of the sidebar (`⌘,`), shows Settings in the same window: see Settings below.

**Search** works inside the selected row; every word has to match. It reads a capture's app, window title, file name and link, and a shared file's name, link and place. `Esc` clears it, and **Search everything** runs it on **All** when a row has no match. On the **Settings** line at the foot, the folder icon opens `~/Floppy` and the arrow opens your files on fpy.sh.

### Spaces

The space switcher shows at the top of the sidebar once your account has a team. Its menu lists:

| Space | What the Library keeps |
| --- | --- |
| **All spaces** | Everything |
| **Personal**, with your photo | The captures on this Mac and the links that aren't in a team |
| Each team, by name, with its logo or initials | The links shared in that team, captures shared there included |
| **New team…** | Opens Settings › Team with the form to make one |

The space narrows the list, the sidebar's counts and Analytics, and it is where **Upload** and a drop on the list send files. Floppy remembers it on this Mac; it never changes your account's default space.

### Upload

Click **Upload**, or press `U` or `⌘U`, and choose files or a folder. Several make one link. You can also drop files on the list: a dashed blue frame says where they'll go, and the link is copied before the upload ends. Files go to the space on show; on **All spaces**, or without a team, to your account's default space.

### Analytics

Click **Analytics** in the sidebar, or press `⌘3`. Its row shows the views of the links in the space on show. `Esc` or any other row goes back to the list.

| Part | What it shows |
| --- | --- |
| Views | Every view, ever, of the links in the Library (your 200 newest) |
| People | Different people in the last 7 days, bots not counted. Someone without a name or email counts by place, device and browser, so it's an estimate |
| Downloads, Time reading | The last 7 days; time reading says across how many visits |
| Visits, last 7 days | A bar a day, today in solid blue, and how many read to the end |
| Live | Who opened, came back to, read all of or downloaded which link, newest first, up to 12 |
| Top links | The 6 most viewed links, with views ever and visits this week |
| Countries, Devices | Where this week's visits came from, and on what |

Everything but Views and Top links comes from the activity feed: your own links, without your own visits, bots, link previews or links with **Notify me** off. While it's open, Analytics asks for new events every 15 seconds. **Open on fpy.sh ↗** opens fpy.sh/app/analytics, which also has who to follow up with, where views come from and what was filtered out.

### Grid or list

The **Grid** or **List** switch is at the top right; `⌘1` is the grid and `⌘2` the list. Floppy remembers the one you used last. The grid shows large pictures with their facts underneath. The list shows one thing per row: a small picture, its name, its kind, its link and views, and the date.

### Captures

- **What each one shows:** the app it was taken in, with the app's icon, the window's title, the day and time, and its fpy.sh link once shared. When that link is among your 200 newest, its place and views show too. Floppy saves the app and title with each new screenshot, on your Mac only. Older screenshots, recordings and GIFs show their kind and date.
- **Click** a capture to put its card back at the bottom left of the screen, with the same actions as right after you took it. A shared capture comes back with its link.
- **On hover:** **Share link** (or **Copy link** once shared), **Copy**, the pencil (annotate) or scissors (trim), the pin, the folder (show in Finder) and the bin (move to the Trash; a shared link keeps working). Double-click opens the editor or the trim window. The right-click menu has the same, and **Delete Link…** for a shared capture.
- Captures are kept until you delete them; the bin also moves the copy in `~/Floppy` to the Trash.

### Shared files

- **How many:** the 200 newest links. With 200 or more, a line says so, and **See all on fpy.sh ↗** opens fpy.sh/app for the rest.
- **What each one shows:** a thumbnail when there is one (a tag with the file's kind otherwise), its name, the day and time, its fpy.sh link, its size, its views, and its place: the team's name or **Personal**. A link an agent made with an API key is labelled **Agent**. A link that is uploading, expired or deleted says so.
- **On hover or right-click:** **Copy link**, **Open** and **Delete link**. A Markdown file opens in Floppy's reader (**Open in Browser**, in its right-click menu, opens its page instead). Any other file opens its page in your browser, signed in. A double-click opens it too. Delete link asks first: the link stops working for everyone who has it, and you may be able to get it back on fpy.sh, under Recently deleted.
- **Stats and settings:** select a file and press `I`, or click the **ⓘ** button in the bar. See the next section.
- **Not in the Library:** files older than the 200 newest, and folders. Those are on fpy.sh/app.

### A shared file's stats and settings

Select a shared file and press `I`, or click the **ⓘ** button in the bar (Floppy for Mac 1.15.0 or later). A panel opens to the right of the list, and the window widens to make room. `I` or `Esc` closes it. At the top: the file's name, its link with **Copy link**, **Open**, and **Replace file**.

| Part | What it has |
| --- | --- |
| Stats | Views, visitors, time read and downloads; views over the last 14 days; average time on each page; the people who opened it, with each of their visits; countries, devices and referrers; the link's activity; who is reading now |
| Settings | Name, address (`fpy.sh/…`), expiry, password, who can open it (team links), folder, downloads, email gate, search engines, notify me, who can edit (Markdown), the note |
| Shares | One link per person: a label, then **Create & copy** |
| Moving and deleting | **Move to** a team (it doesn't move back), **Delete link**, and **Recover** for a deleted or expired link |

Bots, scanners and link previews are kept out of every count. Only **Delete forever**, for a deleted link, opens fpy.sh in your browser.

### Keyboard shortcuts in the Library

The arrow keys move a blue ring through the list; the other keys act on the selected item. The keyboard button in the bar, or `⌘/`, shows this list, and tooltips and right-click menus show each key.

| Key | On a capture | On a shared file |
| --- | --- | --- |
| `←` `→` `↑` `↓` | Move through the list | The same |
| `Return` | Bring the capture's card back | Copy the link |
| `Space` | Quick Look | Open it: Markdown in Floppy's reader, anything else as its page |
| `⌘C` | Copy the picture or file | Copy the link |
| `⌘L` | Share a link, or copy it | Copy the link |
| `E` or `⌘E` | Annotate a screenshot, or trim a recording | |
| `P` | Pin a screenshot | |
| `⌘⌫` | Move to the Trash | Delete the link, after it asks |
| `⌥↑` `⌥↓` | Move through the sidebar | The same |
| `I` | | Show or hide its stats and settings |
| `⌘1` `⌘2` | Grid, List | The same |
| `⌘3` | Analytics | The same |
| `⌘U` or `U` | Upload files to the space on show | The same |
| `⌘F` or `/` | Search | The same |
| `Esc` | Leave Analytics, clear the search, then the selection | The same |
| `⌘R` | Reload | The same |
| `⌘/` | Show or hide the list of keys | The same |
| `⌘W` | Close the window | The same |
| `⌘,` | Open Settings | The same |

In Settings, `↑` and `↓` move through the sections and `Esc` goes back to the Library.

While you type in the search field, letters, arrows, Return and Space belong to the field. The Library plays Floppy's quiet sounds for a selection, a copy, a delete and a change of view; they stay silent when the Mac's interface sounds are off.

## Record the screen

Press `⌥⇧⌘5`, or choose **Record Screen…** in the menu bar icon's right-click menu. The screen holds still as for a screenshot: drag an area, press Space and click a window, or click without dragging to record the whole display. `Esc` cancels.

- **A 3, 2, 1 countdown** shows in the middle of what you picked. `Esc` or `⌥⇧⌘5` cancels it; a click on the number starts at once.
- **While it records,** a thin blue frame marks an area (not a window or a whole screen), and the menu bar icon is a **stop button** with the elapsed time. Click it or press `⌥⇧⌘5` to stop. The right-click menu has **Stop Recording** and **Cancel Recording**.
- **What's recorded:** an H.264 MP4 at 30 fps, the long side at most 3840 px, with the cursor (clicks aren't drawn). Floppy's own cards, frame and countdown are left out. A recorded window that closes, or a display that goes away, ends the recording and keeps it.
- **Sound:** the microphone only, when **Settings › Recordings › Record microphone** is on (macOS 15 and later). No system audio.
- **The recording lands on a card,** its first frame with ▶ and its length. **Copy** puts the file on the clipboard, **Share link** uploads it, and ✂ (top left) trims it. It's saved like a screenshot, as `Screen Recording 2026-11-19 at 14.02.31.mp4`.
- **Size:** about 58 MB a minute at 2880 × 1800, much less when little moves. Floppy's free plan takes files up to 500 MB.

## Trim a recording, or save it as a GIF

Click ✂ on the recording's card, or choose **Trim Last Recording** in the right-click menu. The window shows the recording over a filmstrip, with two blue handles for the start and the end and a playhead. The bottom right shows the range's length and its estimated size.

| Key | What it does |
| --- | --- |
| `Space` | Play or pause, looping inside the range |
| `←` `→` | One frame back or forward; with `⇧`, one second |
| `I` `O` | Set the start or the end at the playhead |
| `⌘S` or `Return` | Done |
| `Esc` | Close (asks **Keep your changes?** when there are any) |

- **Done** re-encodes the range under the same name, in the same places, so the cut is exact to the frame. The untouched recording stays next to it, so the trim window shows the whole thing again and the range can change later. The range is at least 0.5 seconds.
- **Already shared?** Done also replaces the file behind the same fpy.sh link. The card says **Updating fpy.sh/k3x9…**, then **Same link, new recording ✓**.
- **Save as GIF** makes a looping GIF of the range: 15 fps, at most 960 px wide, up to 30 seconds (a longer range turns the button off). Frames that don't change are merged, so still screens stay small. The GIF is saved next to the recording and gets its own card, with Copy, Share link, save and ✕. The trim window stays open and says **GIF saved** with its size.

## Download a post

Type `fpy.sh/` in front of a YouTube, Instagram, Pinterest, TikTok or X post's address in your browser and press Return (Floppy for Mac 1.14.0 or later). The page offers what can be downloaded, and Floppy downloads it on your Mac. A card at the bottom left shows the post's picture and the progress. The file lands in the Library and in `~/Floppy`.

- **No typing:** **Download from Browser Tab**, in the menu bar icon's right-click menu, does the same for the page in front.
- **See how it's done:** **How to Download a Post…**, in the same menu, plays a short demo over your browser any time (Floppy for Mac 1.16.0 or later). It also plays once by itself the first time one of those sites is in front, when Floppy may record the screen.
- **Add downloads to your library**, in Settings › Downloads, also uploads each one to fpy.sh. With a team, you pick the space.

## Convert and compress

Right-click a file in Finder, then choose **Convert to** or **Compress**. Both run on your Mac with macOS's own tools. Nothing is uploaded unless you share the result.

| From | Convert to |
| --- | --- |
| Photos (HEIC, JPG, PNG, TIFF, GIF, BMP, WebP, AVIF) | JPG, PNG, HEIC, TIFF or PDF |
| Videos (MOV, MP4, M4V) | MP4, MOV, M4A (the sound only) or GIF (the first 15 seconds) |
| Audio (M4A, MP3, WAV, AIFF, FLAC, CAF) | M4A, WAV, AIFF or FLAC |
| RTF, HTML and plain text | PDF, DOCX, RTF, plain text or HTML |
| Word documents (DOCX, DOC, ODT) | DOCX, RTF, plain text or HTML (Word to PDF is coming) |
| PDFs | A JPG or PNG per page, or plain text |

The menu lists only the formats every selected file can become.

**Compress** has three levels. Each shows roughly how big the file will be before you pick it.

| Level | What it does |
| --- | --- |
| Light | Keeps the full size and looks the same. For files you still want to edit or print. |
| Balanced | Smaller, still looks good. Retina screenshots become their normal size. For most things you send. |
| Aggressive | As small as it sensibly gets. Photos lose their location. For chat apps and email limits. |

Compress works on JPG, HEIC, PNG and TIFF photos, MOV, MP4 and M4V videos, M4A audio and PDFs, and keeps their format. **Compress › Zip** zips any file.

- **The original is never changed.** The result is saved next to it: `IMG_2041.jpg`, or `interview_fpy_compressed.mov` for a compressed copy. If that folder is read-only, the result goes to Downloads and the card says so.
- **A card at the bottom left** shows the work, then **Share with a Floppy link** and **Show file**.
- **"No smaller copy saved"** means that level couldn't shrink the file by at least 10%. Try a stronger level.

## Read Markdown

Floppy for Mac opens Markdown files in reader windows that look like Floppy's share pages. It opens `.md`, `.markdown`, `.mdown` and `.mkd` files, and needs Floppy for Mac 1.7.0 or later. Reading needs no account. **Share**, **Update link** and incoming versions use your Floppy sign-in.

### Open a file

After the update to 1.7.0, Floppy is the app a double-click on a Markdown file opens. It takes that once, on the first launch of 1.7.0 or on a new install.

| Where | How |
| --- | --- |
| Finder | Double-click the file, or right-click it and choose **Open With › Floppy**. |
| A reader window | Drop a file on it, or use **File › Open…** or **Open Recent**. |
| Menu bar | Right-click the floppy and choose **Open Markdown file…** |
| Finder preview | Press the space bar on the file. The preview is drawn the same way, in the reader's font and theme. |

- **To hand Markdown files back,** switch off **Open Markdown files with Floppy** in Settings, or in the welcome. They go back to the app that had them before, or to TextEdit when there was none. Floppy never takes it again after you switch it off or pick another app in Finder.
- **Dropping a file on the menu bar icon still shares it.**
- **The Dock and `⌘Q`.** Floppy stays in the Dock while it runs, unless **Keep in Dock** is off in Settings; then it shows there only while a document is open. It has the reader's menu bar only while a document is open. `⌘Q` closes the documents and keeps Floppy in the menu bar, so uploads and notifications keep running. Windows never reopen by themselves.

### The window

One bar, the contents on the left, the document in the middle and one panel on the right, the same layout as a share page. This is the window from Floppy for Mac 1.8.0.

- **The bar** has the file's name and folder, **Edit**, the file's link (or **Share**) and **Open in Claude**. Under 860 points wide the folder steps aside.
- **The contents** sit in the left margin. `⌥⌘S` hides or shows them. In a narrow window they open as a drawer over the text, from the list button in the top left corner.
- **The panel** opens from the rail of icons on the right edge, from the link in the bar, or with `⌥⌘I`. Its first view has the link (**Share**, **Copy link**, **Update link…**, **Link settings ↗**), then **Open in another AI**, **Versions** and **Text**, which open in place with a back arrow, then **Copy Markdown**, **Copy as rich text**, **Print or save as PDF** and **Show in Finder**. Under 860 points wide it opens over the text.
- **A dot on the rail** means the link has a version your file doesn't, or the file changed on disk. Both are in **Versions**.
- **The line under the bar** only shows for what needs an answer now: a save that failed, an edit that ran into a change on disk, or the file moved or deleted.
- **Focus** (`⇧⌘F`) leaves only the text.

### What the reader draws

Headings, lists, task lists, tables (number columns right-aligned), code blocks with syntax colours and a **Copy** button, quotes, GitHub-style callouts (`> [!NOTE]`), footnotes, front matter (a row that opens), images, and bare web addresses as links. Diagrams (Mermaid) and math are not in this version.

**Text** in the panel (`⌥⌘T`) holds the text settings. One setting applies to every document.

| Setting | Choices |
| --- | --- |
| Font | Serif, Sans, Mono or Round |
| Theme | Auto, Light, Sepia, Dark or Blackout |
| Size | 14 to 22 |
| Width | Narrow, Medium or Wide |

Measured on an M1 Pro with Floppy already running, a 20 KB document is on screen in about 60 ms. A dense 46 KB one, mostly tables and code, takes about 160 ms.

### Get around a document

A contents list of the `##` and `###` headings sits in the left margin, and a thin line shows how far you've read. Each file's reading position is remembered. Links between `.md` files open in the same window.

| Key | What it does |
| --- | --- |
| `⌘L` | The **Jump to…** field in the contents list |
| `⌥⌘S` | Hide or show the contents |
| `⌥⌘I` | Open or close the panel |
| `⌥⌘↓` and `⌥⌘↑` | Next and previous section |
| `⌘F` | Find |
| `⌘+` and `⌘−` | Bigger and smaller text |
| `⌘[` and `⌘]` | Back and Forward |

### When the file changes on disk

When another app or an AI agent saves the file while it's open, the page updates in place and keeps your place. A dot appears on the rail, and **Versions** in the panel says what happened, like "Changed on disk just now. 2 paragraphs changed, 1 added." The reader can't know who changed the file, so it names nobody.

- **Show changes on disk** (`⌥⌘C`) highlights added words and strikes through removed ones. Added and removed blocks get a bar in the margin, and changed sections get a dot in the contents.
- **Next** jumps to the next change (`⌃⌘↓`).
- **✕** clears it: later changes are measured from there.

### Edit a block

Editing is by block. There is no whole-document editor.

1. Press **Edit** (`⌥⌘E`) and click a block. Or click the small pencil in the margin beside the block under the pointer.
2. The block turns into its Markdown source in place. The rest of the page stays as it reads.
3. Click away or press `⌘↩` to save. `Esc` cancels. Clearing the text removes the block.

- **Tick boxes** tick on a click.
- **A save changes only that block's lines.** Every other line, the line endings, the final newline, the encoding and the file's permissions stay as they were.
- **`⌘Z`** undoes a saved edit.
- **If the file changes on disk while a block is open,** your draft is kept. If that same block changed, both are shown and you choose.

### Share, and keep the link up to date

- **Share** uploads the file the same way as dropping it on the menu bar icon. The link is on your clipboard at once.
- **The bar shows the link,** like `fpy.sh/k3x9 · v1`, with a dot when the file is ahead of it. Click it for the panel. Floppy remembers which link the file belongs to. The app keeps that on this Mac, and nothing is written into the file.
- **Update link…** (`⌥⌘U`) sends the whole file as the next version when the file is ahead of the link, with an optional one-line note. A version can be up to 2 MB.
- **A version from someone else, or their AI,** puts a dot on the rail. **Versions** shows it, like "New on the link: v3 from Sam, 2 min ago, Tightened the intro", above the link's versions. **Show changes** previews their version in the page with the changes marked. **Apply to file** writes it to your file.
- **If both changed,** **Versions** says so. **Update link** puts your file on top as the next version, and theirs stays in the history. **See theirs ↗** opens it on fpy.sh.

Nothing moves between the file and the link by itself, in either direction. Floppy for Mac has no syncing or cloud storage of its own: a Floppy link is the sharing.

### Open in Claude

**Open in Claude** (`⌥⌘O`) is the one accent button. **Open in another AI** in the panel has ChatGPT, Codex, Cursor and **Copy prompt for any AI**.

| The file | What the AI gets |
| --- | --- |
| Shared | The same prompt as the share page: the link to read, and how to push a version back with the `push_version` MCP tool or `PUT /api/v1/links/<slug>/versions`. A version the AI pushes arrives in **Versions**, with a dot on the rail. |
| Shared, and ahead of its link | The panel asks first: update the link and open, or open the link as it is. |
| Not shared | The document's text. Nothing is uploaded to Floppy. A long document is copied to the clipboard instead, with "Copied. Paste it into Claude." |

## Notifications

- **When someone opens, downloads or finishes your file.** Notifications are grouped by link in Notification Center. **Mute this link** stops them for that link.
- **When an upload finishes or fails.** "Upload finished" with the link, or "Upload failed" with what to do.
- **When an update is ready or installed.** Click the notification to install it, or to see what's new.
- **When a teammate adds or updates a file in a team** (Floppy for Mac 1.15.0): "Sam Lee added Pitch.pdf", under the team's name. You get it while **Tell me when someone adds a file** is on for that team; see Teams.
- **When someone joins through your invite:** "Tom Rey joined Side project".

If none arrive, allow notifications for Floppy in **System Settings › Notifications**.

## Updates

With **Update automatically** on (the default), new versions download in the background. Floppy then shows a notification, a dot on the menu bar icon and an **Install now** row at the top of the popover. If you don't click, Floppy installs the update an hour later, once nothing is uploading or converting and the popover is closed. It reopens in a few seconds.

With it off, Floppy still checks once a day and shows the same dot and row, and **Install now** opens the installer. **Check now** in Settings checks at once.

## Settings

Settings live in the Library's window (Floppy for Mac 1.15.0 or later; before, they had a window of their own). Open them with `⌘,`, the **Settings** row at the foot of the Library's sidebar, **Settings…** in the menu bar icon's menu, or the gear in the popover. The sidebar then lists the sections; `↑` and `↓` move through them, and **Library** (`Esc`) goes back.

| Section | What it has |
| --- | --- |
| Account | Your plan, storage and links. Signs this Mac out |
| General | **Launch at login**, **Update automatically** (with **Check now**), **Keep in Dock** and the Dock icon |
| Sharing | **Share card**, **Drop shelf**, **Right-click in Finder** and **After converting** |
| Screenshots | **Save to the Floppy folder** (recordings and GIFs too; off, captures are only in the Library), **Move** for copies an older version saved to the Desktop, the camera **Sound**, and the Screen Recording permission |
| Recordings | **Record microphone** (macOS 15 or later) and the Screen Recording permission |
| Markdown | **Open Markdown files with Floppy** |
| Downloads | **Add downloads to your library**, and the place they go |
| Shortcuts | `⌃⌥⌘F`, **Use Floppy for ⇧⌘3 and ⇧⌘4**, the screenshot and recording shortcuts, and which ones another app holds |
| Team | Your teams: see Teams |
| About | The version, **Welcome** (replays the welcome window), the changelog, help and privacy |

| Setting | What it does |
| --- | --- |
| Share card | Shows the card for uploads, conversions and compressions at the bottom left of the screen. |
| Drop shelf | Slides out the drop shelf when you drag files toward the menu bar. |
| Right-click in Finder | Shows whether the Finder item is on, with a link to turn it on. |
| After converting | What the card does next: **Ask** (the default), **Share right away** or **Just save**. |
| Open Markdown files with Floppy | Makes Floppy the app a double-click on a Markdown file opens. Switch it off to hand Markdown files back to the app that had them before. |
| Launch at login | Starts Floppy when you log in. |
| Update automatically | Downloads and installs new versions. |
| Keep in Dock | Keeps Floppy in the Dock and in `⌘Tab` while it runs. A click on the Dock icon opens the Library, or brings forward a Markdown document or another Floppy window that is open. On by default. Off, Floppy is in the Dock only while a Markdown file is open. |
| Open Floppy from any app | The shortcut, `⌃⌥⌘F`. |

## Teams

A team shares its files: everyone in it sees the team's links and their stats, and the links stay with the team when someone leaves. Settings › **Team** shows yours (Floppy for Mac 1.15.0 or later).

- **Make a team.** Open the team drop-down at the top and choose **New team…**, type a name and click **Create team**. No Slack needed: you're its admin and first member. A team can also come from adding Floppy to Slack, at https://fpy.sh/teams.
- **Switch teams.** The drop-down lists every team you're in. The **⋯** menu beside it renames the team, reconnects Slack (Slack teams), opens it on fpy.sh, or leaves it.
- **For you.** **Tell me when someone adds a file** sends you one email, or a Slack DM on a Slack team, and a Mac notification when a teammate adds or updates a file you can open. It starts on in teams made on Floppy and off in Slack teams. Below it, choose where your new links go: Personal or the team.
- **People.** Admins invite by email at the top: the person gets an email from "*your name* via Floppy" with a **Join** link that works once, for 14 days, with any Google account. Members and pending invites are in one list, each with a **⋯** menu (resend or revoke an invite; remove someone or reassign their links).

Emails about new files are batched per person: one goes out once they've been quiet for 2 minutes, at most 15 minutes after their first file. Each has **Stop emails about** *the team*, which turns the setting off.

## Troubleshooting

- **Share via Floppy isn't in the right-click menu.** Turn it on (step 4 of Set up). Until then, use **Share › Floppy** in the same menu.
- **Convert to or Compress is missing.** You need Floppy 1.5 or later: update from Settings › General › **Check now**. **Convert to** only appears when the selected files share a format they can become.
- **A Markdown file opens in Floppy and you'd rather it didn't.** Switch off **Open Markdown files with Floppy** in Settings. To read one file in Floppy after that, use **Open With › Floppy** in Finder.
- **⇧⌘4 still opens the Mac's screenshot tool.** Turn off the Mac's two "Save picture … as a file" shortcuts (see Take a screenshot), or use `⌃⇧4`. Settings › **Shortcuts** shows which shortcuts Floppy has.
- **Annotate Last Screenshot or Pin Last Screenshot does nothing.** You haven't taken a screenshot with Floppy yet, or you deleted them all. Take one first.
- **A shared screenshot's link still shows the old picture.** fpy.sh checks every new file before it goes live, and the link switches when the check ends. If it couldn't reach fpy.sh, open **Annotate Last Screenshot** and press Done to send it again. A picture that fails the check leaves the old one on the link.
- **A screenshot shortcut or ⌥⇧⌘5 does nothing.** Allow Floppy in **System Settings › Privacy & Security › Screen Recording**, then quit and reopen Floppy if macOS asks. If Settings › Shortcuts says **Another app has ⌥⇧⌘5**, turn that app's shortcut off, or use **Record Screen…** in the menu.
- **Record microphone is greyed out or a recording has no sound.** The microphone needs macOS 15 or later. If macOS said no, click **Allow ↗** next to the switch, or turn Floppy on in **System Settings › Privacy & Security › Microphone**. Floppy doesn't record system audio.
- **Trim Last Recording does nothing.** You haven't recorded with Floppy yet, or you deleted the recordings. Record one first.
- **Save as GIF is greyed out.** GIFs are up to 30 seconds. Drag the handles closer together.
- **A recording won't share.** It's bigger than your plan's file limit (500 MB on Free). Trim it, or record a shorter take.
- **You can't find the new file.** Click **Show file** on the card, or look in Downloads.
- **"macOS didn't let Floppy read that file."** Allow it in **System Settings › Privacy & Security › Files & Folders**.
- **An upload failed.** Check your connection. Floppy retries by itself after sleep or a dropped connection. If your plan is full, free up space or upgrade at https://fpy.sh/app.
- **You want to sign out or uninstall.** Sign out in Settings › **Account**. To uninstall, right-click the floppy in the menu bar and choose **Quit Floppy**, then drag Floppy from Applications to the Bin. Either way, your links keep working.

Still stuck? Write to lamine@fpy.sh.
