Floppy

Mac guide

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.

fpy.sh/docs/mac · Download for Mac · This page as Markdown

Set up

Set up Floppy for Mac in five steps.

  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

Five ways to share a file from your Mac.

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

WhereHow
Menu barDrop files on the floppy. Drag toward the top right of the screen and a bigger drop shelf slides out.
FinderRight-click files, then Share via Floppy. In a team, it offers Personal or your team, with your default first.
Finder's Share menuShare › Floppy. It works even when the right-click item is off.
The popoverClick the floppy, then drop files on it or click Choose….
WidgetsShare 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

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

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.
ToolKeyWhat it does
SelectV or EscMove, resize, or delete (⌫) a shape. Arrow keys nudge it 1 point, ⇧ 10
CropCDrag the edges, Enter applies, Esc cancels. The original is kept
RectangleRF switches outline and filled. ⇧ for a square
EllipseO⇧ for a circle
LineL⇧ snaps to 45°
ArrowAA line with a swept-back head sized to its width. ⇧ snaps to 45°
PencilPDraws freehand
HighlighterHDrag a rectangle. The colour is laid over the picture like a marker, so text under it stays readable
TextTClick, type, click away. Double-click to edit again
BlurBPixelates, then blurs the area
NumberNEach 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

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

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.

RowWhat the list keeps
AllEverything
ScreenshotsScreenshots
RecordingsScreen recordings and GIFs
Shared filesThe files you shared that aren't captures
With a linkShared files, and captures you shared. It shows once something has a link
PlacesWhat 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
AppsThe 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 typesShared 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:

SpaceWhat the Library keeps
All spacesEverything
Personal, with your photoThe captures on this Mac and the links that aren't in a team
Each team, by name, with its logo or initialsThe 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.

PartWhat it shows
ViewsEvery view, ever, of the links in the Library (your 200 newest)
PeopleDifferent 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 readingThe last 7 days; time reading says across how many visits
Visits, last 7 daysA bar a day, today in solid blue, and how many read to the end
LiveWho opened, came back to, read all of or downloaded which link, newest first, up to 12
Top linksThe 6 most viewed links, with views ever and visits this week
Countries, DevicesWhere 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.

PartWhat it has
StatsViews, 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
SettingsName, 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
SharesOne link per person: a label, then Create & copy
Moving and deletingMove 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.

KeyOn a captureOn a shared file
← → ↑ ↓Move through the listThe same
ReturnBring the capture's card backCopy the link
SpaceQuick LookOpen it: Markdown in Floppy's reader, anything else as its page
⌘CCopy the picture or fileCopy the link
⌘LShare a link, or copy itCopy the link
E or ⌘EAnnotate a screenshot, or trim a recording
PPin a screenshot
⌘⌫Move to the TrashDelete the link, after it asks
⌥↑ ⌥↓Move through the sidebarThe same
IShow or hide its stats and settings
⌘1 ⌘2Grid, ListThe same
⌘3AnalyticsThe same
⌘U or UUpload files to the space on showThe same
⌘F or /SearchThe same
EscLeave Analytics, clear the search, then the selectionThe same
⌘RReloadThe same
⌘/Show or hide the list of keysThe same
⌘WClose the windowThe same
⌘,Open SettingsThe 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

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

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.

KeyWhat it does
SpacePlay or pause, looping inside the range
← →One frame back or forward; with ⇧, one second
I OSet the start or the end at the playhead
⌘S or ReturnDone
EscClose (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

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

Convert or compress a file in Finder, on your Mac.

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.

FromConvert 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 textPDF, DOCX, RTF, plain text or HTML
Word documents (DOCX, DOC, ODT)DOCX, RTF, plain text or HTML (Word to PDF is coming)
PDFsA 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.

LevelWhat it does
LightKeeps the full size and looks the same. For files you still want to edit or print.
BalancedSmaller, still looks good. Retina screenshots become their normal size. For most things you send.
AggressiveAs 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

Read, edit and share Markdown files in Floppy for Mac.

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.

WhereHow
FinderDouble-click the file, or right-click it and choose Open With › Floppy.
A reader windowDrop a file on it, or use File › Open… or Open Recent.
Menu barRight-click the floppy and choose Open Markdown file…
Finder previewPress 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.

SettingChoices
FontSerif, Sans, Mono or Round
ThemeAuto, Light, Sepia, Dark or Blackout
Size14 to 22
WidthNarrow, 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.

KeyWhat it does
⌘LThe Jump to… field in the contents list
⌥⌘SHide or show the contents
⌥⌘IOpen or close the panel
⌥⌘↓ and ⌥⌘↑Next and previous section
⌘FFind
⌘+ 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 fileWhat the AI gets
SharedThe 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 linkThe panel asks first: update the link and open, or open the link as it is.
Not sharedThe document's text. Nothing is uploaded to Floppy. A long document is copied to the clipboard instead, with "Copied. Paste it into Claude."
Notifications

The notifications Floppy for Mac sends.

  • 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

How Floppy for Mac updates itself.

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

The settings in Floppy for Mac.

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.

SectionWhat it has
AccountYour plan, storage and links. Signs this Mac out
GeneralLaunch at login, Update automatically (with Check now), Keep in Dock and the Dock icon
SharingShare card, Drop shelf, Right-click in Finder and After converting
ScreenshotsSave 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
RecordingsRecord microphone (macOS 15 or later) and the Screen Recording permission
MarkdownOpen Markdown files with Floppy
DownloadsAdd 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
TeamYour teams: see Teams
AboutThe version, Welcome (replays the welcome window), the changelog, help and privacy
SettingWhat it does
Share cardShows the card for uploads, conversions and compressions at the bottom left of the screen.
Drop shelfSlides out the drop shelf when you drag files toward the menu bar.
Right-click in FinderShows whether the Finder item is on, with a link to turn it on.
After convertingWhat the card does next: Ask (the default), Share right away or Just save.
Open Markdown files with FloppyMakes 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 loginStarts Floppy when you log in.
Update automaticallyDownloads and installs new versions.
Keep in DockKeeps 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 appThe shortcut, ⌃⌥⌘F.
Teams

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

Fixes for common problems with Floppy for Mac.

  • 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.