Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions docs/site/android-file-transfer-not-working.html
Original file line number Diff line number Diff line change
Expand Up @@ -138,14 +138,16 @@ <h2>Questions</h2>
</article>

<footer>
<p class="platform">Apple Silicon, macOS 13 or later. <strong>Signed by Apple.</strong></p>
<p class="links">
<a href="https://github.com/terraceonhigh/Comprador/releases/latest">Download</a>
<a class="nav" href="index.html">Home</a>
<a class="nav" href="compatibility.html">Compatibility</a>
<a class="nav" href="compare.html">Compare</a>
<a class="nav" href="honourable-mentions.html">Honourable mentions</a>
<a href="https://github.com/terraceonhigh/Comprador">Source</a>
<a href="https://github.com/terraceonhigh/Comprador/blob/master/LICENSE">License (GPLv3+)</a>
<button id="funToggle" type="button" class="funlinks" aria-pressed="false">Fun mode</button>
</p>
<p class="also"><em>Also worth knowing about:</em> <a href="https://github.com/sannidhyaroy/Soduto">Soduto</a>, a macOS client for KDE Connect, because, Apple or not, you want your devices in symphony.</p>
<p class="privacy">No trackers, no third-party requests.</p>
</footer>

</main>
Expand Down
8 changes: 5 additions & 3 deletions docs/site/compare.html
Original file line number Diff line number Diff line change
Expand Up @@ -100,14 +100,16 @@ <h2>Where Comprador loses</h2>
</article>

<footer>
<p class="platform">Apple Silicon, macOS 13 or later. <strong>Signed by Apple.</strong></p>
<p class="links">
<a href="https://github.com/terraceonhigh/Comprador/releases/latest">Download</a>
<a class="nav" href="index.html">Home</a>
<a class="nav" href="compatibility.html">Compatibility</a>
<span class="nav" aria-current="page">Compare</span>
<a class="nav" href="honourable-mentions.html">Honourable mentions</a>
<a href="https://github.com/terraceonhigh/Comprador">Source</a>
<a href="https://github.com/terraceonhigh/Comprador/blob/master/LICENSE">License (GPLv3+)</a>
<button id="funToggle" type="button" class="funlinks" aria-pressed="false">Fun mode</button>
</p>
<p class="also"><em>Also worth knowing about:</em> <a href="https://github.com/sannidhyaroy/Soduto">Soduto</a>, a macOS client for KDE Connect, because, Apple or not, you want your devices in symphony.</p>
<p class="privacy">No trackers, no third-party requests.</p>
</footer>

</main>
Expand Down
8 changes: 5 additions & 3 deletions docs/site/compatibility.html
Original file line number Diff line number Diff line change
Expand Up @@ -140,14 +140,16 @@ <h2>If your device doesn't show up</h2>
</article>

<footer>
<p class="platform">Apple Silicon, macOS 13 or later. <strong>Signed by Apple.</strong></p>
<p class="links">
<a href="https://github.com/terraceonhigh/Comprador/releases/latest">Download</a>
<a class="nav" href="index.html">Home</a>
<span class="nav" aria-current="page">Compatibility</span>
<a class="nav" href="compare.html">Compare</a>
<a class="nav" href="honourable-mentions.html">Honourable mentions</a>
<a href="https://github.com/terraceonhigh/Comprador">Source</a>
<a href="https://github.com/terraceonhigh/Comprador/blob/master/LICENSE">License (GPLv3+)</a>
<button id="funToggle" type="button" class="funlinks" aria-pressed="false">Fun mode</button>
</p>
<p class="also"><em>Also worth knowing about:</em> <a href="https://github.com/sannidhyaroy/Soduto">Soduto</a>, a macOS client for KDE Connect, because, Apple or not, you want your devices in symphony.</p>
<p class="privacy">No trackers, no third-party requests.</p>
</footer>

</main>
Expand Down
8 changes: 5 additions & 3 deletions docs/site/garmin.html
Original file line number Diff line number Diff line change
Expand Up @@ -120,14 +120,16 @@ <h2>Questions</h2>
</article>

<footer>
<p class="platform">Apple Silicon, macOS 13 or later. <strong>Signed by Apple.</strong></p>
<p class="links">
<a href="https://github.com/terraceonhigh/Comprador/releases/latest">Download</a>
<a class="nav" href="index.html">Home</a>
<a class="nav" href="compatibility.html">Compatibility</a>
<a class="nav" href="compare.html">Compare</a>
<a class="nav" href="honourable-mentions.html">Honourable mentions</a>
<a href="https://github.com/terraceonhigh/Comprador">Source</a>
<a href="https://github.com/terraceonhigh/Comprador/blob/master/LICENSE">License (GPLv3+)</a>
<button id="funToggle" type="button" class="funlinks" aria-pressed="false">Fun mode</button>
</p>
<p class="also"><em>Also worth knowing about:</em> <a href="https://github.com/sannidhyaroy/Soduto">Soduto</a>, a macOS client for KDE Connect, because, Apple or not, you want your devices in symphony.</p>
<p class="privacy">No trackers, no third-party requests.</p>
</footer>

</main>
Expand Down
121 changes: 121 additions & 0 deletions docs/site/honourable-mentions.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,121 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Honourable mentions · Comprador</title>
<meta name="description" content="The tools and projects Comprador tips its hat to: OpenMTP, the project it forked from; libmtp, the engine it is built on; Soduto and KDE Connect for wireless; MacDroid; and Android File Transfer, the one that came before.">
<link rel="canonical" href="https://terraceonhigh.github.io/Comprador/honourable-mentions.html">
<meta name="theme-color" content="#f4ebe1">
<link rel="icon" href="images/icon.png">

<meta property="og:type" content="article">
<meta property="og:title" content="Honourable mentions · Comprador">
<meta property="og:description" content="The tools and projects Comprador tips its hat to — the one it forked from, the engine it is built on, and the ones that do a job it doesn't.">
<meta property="og:url" content="https://terraceonhigh.github.io/Comprador/honourable-mentions.html">
<meta property="og:image" content="https://terraceonhigh.github.io/Comprador/images/demo-light.png">
<meta name="twitter:card" content="summary_large_image">

<link rel="stylesheet" href="style.css">
<link rel="stylesheet" href="guide.css">
<script src="script.js"></script>
</head>
<body>

<header class="topbar">
<a class="wordmark" href="index.html">Comprador</a>
<a class="btn small" href="https://github.com/terraceonhigh/Comprador/releases/latest">Download</a>
</header>

<main>
<article class="guide">
<h1>Honourable mentions</h1>
<p class="lead">Comprador isn't the only good way to move files between a phone and a Mac, and it
stands on open-source work that came before it. Honest brokerage means saying so. Here are the
projects we tip our hat to.</p>

<h2>The ones we stand on</h2>
<p><strong><a href="https://github.com/ganeshrvel/openmtp">OpenMTP</a></strong> is the project
Comprador was forked from. It's a free, open-source MTP app for macOS that gives you a dedicated
dual-pane file-manager window, and for years it was the answer for Android-on-Mac. Comprador took
a different shape — a Finder volume instead of a window, and a clean reimplementation underneath —
but the repository began as OpenMTP's, and the debt is real.</p>
<p><strong><a href="https://github.com/libmtp/libmtp">libmtp</a></strong> is the engine. It's the C
library that actually speaks the Media Transfer Protocol to your device — the decade-plus of
reverse-engineering and per-device quirk-handling that makes any of this possible. Comprador is,
in honest terms, a friendly face on libmtp's work. It ships bundled in the app, with its licence.</p>

<h2>Kindred libraries</h2>
<p>Comprador isn't the only project that pries a closed device open and hands everyone the result —
it belongs to a long tradition of it. <strong><a href="https://libimobiledevice.org/">libimobiledevice</a></strong>
did for the iPhone what libmtp did for MTP: a volunteer community reverse-engineered Apple's locked
sync protocols so any operating system could talk to an iPhone or iPad — no iTunes, no jailbreak —
and then gave the work away. <strong><a href="https://github.com/gphoto/libgphoto2">libgphoto2</a></strong>
does the same for digital cameras, the decades of protocol-wrangling behind gPhoto2. All three are
one act of generosity pointed at different hardware, freely licensed, and Comprador is a small
Mac-shaped continuation of it.</p>

<h2>For a job we don't do</h2>
<p><strong><a href="https://kdeconnect.kde.org/">KDE Connect</a></strong> and its macOS client
<strong><a href="https://github.com/sannidhyaroy/Soduto">Soduto</a></strong> move files over
Wi-Fi, not USB. Comprador is deliberately USB-only, so if you'd rather not reach for a cable — and
you want notifications, clipboard sync and remote control thrown in — this is the wireless half of
the story. Apple or not, you want your devices in symphony.</p>
<p><strong><a href="https://localsend.org/">LocalSend</a></strong> is the open-source way to do the
same across your own network — fling a file from phone to laptop, or between any two platforms, with
no account, no cloud, and nothing leaving the local Wi-Fi. Think AirDrop that doesn't care who made
your devices.</p>
<p><strong><a href="https://github.com/Genymobile/scrcpy">scrcpy</a></strong> does a different job
again: it mirrors and controls your Android screen from the Mac over USB, and it's some of the
most-loved free software in the Android world (Apache-2.0). Its one catch is the very thing Comprador
spares you — it speaks ADB, so you'll need Developer Options and USB debugging switched on. For files
that's friction we'd rather skip; for driving the whole phone from your desk, it's well worth it.</p>

<h2>The one that came before</h2>
<p><strong><a href="https://www.android.com/filetransfer/">Android File Transfer</a></strong> is
where almost everyone started, and the reason this whole category exists. Google quietly pulled its
download in early 2024, and it's now effectively gone: unmaintained, a 4&nbsp;GB file cap, and
increasingly broken on Apple Silicon. We mention it because it walked so the rest could mount.</p>

<p class="note">On Linux none of this is needed in the same way —
<a href="https://github.com/phatina/simple-mtpfs">simple-mtpfs</a>, jmtpfs, and GNOME's gvfs
already expose MTP devices through the file manager. Comprador exists because macOS doesn't.</p>

<h2>The look of the place</h2>
<p>Comprador wears two-hundred-year-old engravings, and we owe that to people long gone and to the
institutions that keep their work free. The butterfly on the pomegranate in the icon is a detail
from a 1705 plate by <strong>Maria Sibylla Merian</strong> — an early naturalist who documented
insect metamorphosis from life — engraved by <strong>Pieter Sluyter</strong>. The shifting backdrop
behind every page is the work of <strong>Filippo Morghen</strong>, an 18th-century Italian engraver,
from his series imagining fantastical life on the Moon.</p>
<p>Both reach us, scanned and unlocked, through the
<strong><a href="https://pdimagearchive.org/">Public Domain Image Archive</a></strong> and the
<strong><a href="https://www.biodiversitylibrary.org/">Biodiversity Heritage Library</a></strong>
with the Smithsonian. The works are public domain worldwide; the organizations that digitize and
release them are the reason a small free app can dress itself in museum-grade art for nothing. The
typefaces are the same kind of gift — Bona Nova, Igino Marini's IM Fell Double Pica SC, Fasthand and
Syne Mono, all offered freely under the SIL Open Font License. Full credits and licences are in the
project's <a href="https://github.com/terraceonhigh/Comprador/blob/master/NOTICES.md">third-party notices</a>.</p>

<div class="cta">
<a class="btn" href="https://github.com/terraceonhigh/Comprador/releases/latest">Download for Mac</a>
<a class="btn ghost" href="index.html">What is Comprador?</a>
</div>
</article>

<footer>
<p class="links">
<a class="nav" href="index.html">Home</a>
<a class="nav" href="compatibility.html">Compatibility</a>
<a class="nav" href="compare.html">Compare</a>
<span class="nav" aria-current="page">Honourable mentions</span>
<a href="https://github.com/terraceonhigh/Comprador">Source</a>
<a href="https://github.com/terraceonhigh/Comprador/blob/master/LICENSE">License (GPLv3+)</a>
<button id="funToggle" type="button" class="funlinks" aria-pressed="false">Fun mode</button>
</p>
<p class="privacy">No trackers, no third-party requests.</p>
</footer>

</main>
</body>
</html>
18 changes: 9 additions & 9 deletions docs/site/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -207,13 +207,11 @@
footer { text-align: center; padding: 40px 0 80px; color: var(--faint);
font-size: 0.9rem; max-width: 40em; margin: 0 auto; }
footer .platform { color: var(--muted); margin-bottom: 1.8em; }
footer .also a { color: var(--link); }
footer .privacy { font-size: 0.78rem; color: var(--faint); letter-spacing: 0.02em; }
footer .links { margin: 0 0 1.6em; }
footer .links a { margin: 0 10px; color: var(--muted); }
/* quiet, verifiable privacy line: no markup needed, same on every page */
footer::after { content: "No trackers. No third-party requests. Fonts and assets self-hosted.";
display: block; margin-top: 2.4em; font-size: 0.78rem; color: var(--faint);
letter-spacing: 0.02em; }
footer .links a.nav { color: var(--link); }
footer .links span.nav { margin: 0 10px; color: var(--faint); }

/* ---- Fun Mode: swap the whole page to Fasthand. The control is an inline
footer link, coloured to match the adjacent Download/Source/License links. ---- */
Expand Down Expand Up @@ -266,7 +264,7 @@ <h1>Comprador</h1>
<a class="btn" href="https://github.com/terraceonhigh/Comprador/releases/latest/download/Comprador.dmg">Download for Mac</a>
<a class="btn ghost" href="https://github.com/terraceonhigh/Comprador">View source on GitHub</a>
</div>
<p class="reqline">Free and open source · Apple Silicon · macOS 13 or later</p>
<p class="reqline">Free and open source · Apple Silicon · macOS 13 or later · <strong>Signed by Apple.</strong></p>
<p class="seo-note">A modern Android File Transfer alternative</p>

<div class="shot">
Expand Down Expand Up @@ -305,14 +303,16 @@ <h2>Not just one trick.</h2>
</div>

<footer>
<p class="platform">Apple Silicon, macOS 13 or later. <strong>Signed by Apple.</strong> </p>
<p class="links">
<a href="https://github.com/terraceonhigh/Comprador/releases/latest">Download</a>
<span class="nav" aria-current="page">Home</span>
<a class="nav" href="compatibility.html">Compatibility</a>
<a class="nav" href="compare.html">Compare</a>
<a class="nav" href="honourable-mentions.html">Honourable mentions</a>
<a href="https://github.com/terraceonhigh/Comprador">Source</a>
<a href="https://github.com/terraceonhigh/Comprador/blob/master/LICENSE">License (GPLv3+)</a>
<button id="funToggle" type="button" class="funlinks" aria-pressed="false">Fun mode</button>
</p>
<p class="also"><em>Also worth knowing about:</em> <a href="https://github.com/sannidhyaroy/Soduto">Soduto</a>, a macOS client for KDE Connect, because symphony beats soliloquy</p>
<p class="privacy">No trackers, no third-party requests.</p>
</footer>

</main>
Expand Down
8 changes: 5 additions & 3 deletions docs/site/kindle.html
Original file line number Diff line number Diff line change
Expand Up @@ -120,14 +120,16 @@ <h2>Questions</h2>
</article>

<footer>
<p class="platform">Apple Silicon, macOS 13 or later. <strong>Signed by Apple.</strong></p>
<p class="links">
<a href="https://github.com/terraceonhigh/Comprador/releases/latest">Download</a>
<a class="nav" href="index.html">Home</a>
<a class="nav" href="compatibility.html">Compatibility</a>
<a class="nav" href="compare.html">Compare</a>
<a class="nav" href="honourable-mentions.html">Honourable mentions</a>
<a href="https://github.com/terraceonhigh/Comprador">Source</a>
<a href="https://github.com/terraceonhigh/Comprador/blob/master/LICENSE">License (GPLv3+)</a>
<button id="funToggle" type="button" class="funlinks" aria-pressed="false">Fun mode</button>
</p>
<p class="also"><em>Also worth knowing about:</em> <a href="https://github.com/sannidhyaroy/Soduto">Soduto</a>, a macOS client for KDE Connect, because, Apple or not, you want your devices in symphony.</p>
<p class="privacy">No trackers, no third-party requests.</p>
</footer>

</main>
Expand Down
5 changes: 5 additions & 0 deletions docs/site/sitemap.xml
Original file line number Diff line number Diff line change
Expand Up @@ -35,4 +35,9 @@
<lastmod>2026-06-23</lastmod>
<changefreq>monthly</changefreq>
</url>
<url>
<loc>https://terraceonhigh.github.io/Comprador/honourable-mentions.html</loc>
<lastmod>2026-06-24</lastmod>
<changefreq>monthly</changefreq>
</url>
</urlset>
8 changes: 3 additions & 5 deletions docs/site/style.css
Original file line number Diff line number Diff line change
Expand Up @@ -107,13 +107,11 @@ main {
footer { text-align: center; padding: 40px 0 80px; color: var(--faint);
font-size: 0.9rem; max-width: 40em; margin: 0 auto; }
footer .platform { color: var(--muted); margin-bottom: 1.8em; }
footer .also a { color: var(--link); }
footer .privacy { font-size: 0.78rem; color: var(--faint); letter-spacing: 0.02em; }
footer .links { margin: 0 0 1.6em; }
footer .links a { margin: 0 10px; color: var(--muted); }
/* quiet, verifiable privacy line: no markup needed, same on every page */
footer::after { content: "No trackers. No third-party requests. Fonts and assets self-hosted.";
display: block; margin-top: 2.4em; font-size: 0.78rem; color: var(--faint);
letter-spacing: 0.02em; }
footer .links a.nav { color: var(--link); }
footer .links span.nav { margin: 0 10px; color: var(--faint); }

/* Fun Mode: swaps the whole page to Fasthand; the brand wordmark holds via --font-brand */
html.fun { --font-body: "Fasthand", "Bona Nova", cursive; }
Expand Down
8 changes: 5 additions & 3 deletions docs/site/switch.html
Original file line number Diff line number Diff line change
Expand Up @@ -122,14 +122,16 @@ <h2>Questions</h2>
</article>

<footer>
<p class="platform">Apple Silicon, macOS 13 or later. <strong>Signed by Apple.</strong></p>
<p class="links">
<a href="https://github.com/terraceonhigh/Comprador/releases/latest">Download</a>
<a class="nav" href="index.html">Home</a>
<a class="nav" href="compatibility.html">Compatibility</a>
<a class="nav" href="compare.html">Compare</a>
<a class="nav" href="honourable-mentions.html">Honourable mentions</a>
<a href="https://github.com/terraceonhigh/Comprador">Source</a>
<a href="https://github.com/terraceonhigh/Comprador/blob/master/LICENSE">License (GPLv3+)</a>
<button id="funToggle" type="button" class="funlinks" aria-pressed="false">Fun mode</button>
</p>
<p class="also"><em>Also worth knowing about:</em> <a href="https://github.com/sannidhyaroy/Soduto">Soduto</a>, a macOS client for KDE Connect, because, Apple or not, you want your devices in symphony.</p>
<p class="privacy">No trackers, no third-party requests.</p>
</footer>

</main>
Expand Down
Loading