v0.7.0

Rip your Blu-rays and DVDs straight onto your NAS. One box, one cable, no
babysitting. Download the Preparer, let it write an SD card, plug the box in.

Your computer	Download	Then
macOS	riparr-preparer-macos.dmg	Open it, drag Riparr Preparer into Applications
Windows	riparr-preparer-windows-beta.exe	Double-click it
Linux	riparr-preparer-linux-beta.tar.gz	Unpack it, run Riparr Preparer
Linux on ARM	riparr-preparer-linux-arm64-beta.tgz	Unpack it, run Riparr Preparer

Nothing is code-signed yet, so your computer will block it the first time. On macOS,
double-click it, let it get refused, then go to System Settings → Privacy &
Security, scroll to the bottom and click Open Anyway. On Windows, if
Edge holds the download choose … → Keep → Keep anyway, then Run (or
More info → Run anyway).

Already running Riparr? The box updates itself from System → Updates, and
the Preparer updates itself from the sidebar. You do not need to download
riparr-server.tar.gz or versions.json by hand.

User guide · Which drive to buy

What changed in 0.7.0

TV seasons on Blu-ray, tested on real discs. The first fidelity tests with real
Blu-ray TV box sets are passing: every season of Samurai Jack and Avatar: The Last
Airbender's Book One and Book Two. Put a season disc in and each episode comes out as
its own file, in the order the disc plays them, named and numbered for Plex and
Jellyfin. Disc 2 carries on where disc 1 stopped. Put disc 3 in before disc 2 and it's
ripped anyway, then filed by itself as soon as disc 2 is done.

TV on DVD gets checked by you before it's filed. DVDs come from an older, more
archaic way of building disc menus, and they don't keep a reliable record of what order
the episodes go in. So a DVD season is ripped and ejected as usual, then waits on the
Queue page for you to confirm the order before anything lands in your library. If you'd
rather it guessed, set When Riparr isn't sure about a season to Never.

Episode names are double-checked. TVmaze names the episodes and Wikidata checks
them. When the two agree, the plan says so. When they disagree about the show, or count
the season differently, the filing waits for you instead of guessing.

The details a real box set throws at you:

• Two shows with the same name (the 2005 Avatar and the 2024 one) are told apart by
  episode length and season count.
• A disc called "Book One" or "Volume 2" is read as a season, and the disc's own full
  name is used instead of its 32-character label.
• Commentary-only copies of an episode are skipped. You get the version with the real
  soundtrack, and the commentary comes along as an extra track when the disc has one.
• Two episodes stored as one video are filed as one file, like S02E12-E13, carrying
  both episode names.
• Bonus episodes and featurettes are offered as extras. Tick them and they go in the
  show's Featurettes folder.
• A single episode that fails to rip costs that episode, not the season. Put the disc
  back in and only what's missing is read.

Auto Rip by kind of disc. Settings has a row each for films, TV seasons, music CDs
and data discs: rip it, show me first, or leave it alone. Films and TV can bring their
extras along too.

Data discs are saved as ISO images, in a Data folder with its own destination.

The box looks after itself.

• Keep the box cool holds the Orange Pi at a lower clock while it reads a disc. It
  costs nothing in rip speed and keeps it well clear of its temperature limit. A hot box
  pauses between episodes to cool down.
• A frozen box now reboots itself, and takes riparr.local back afterwards instead of
  turning up as riparr-2.local.
• On the Orange Pi Zero 2W, Bluetooth is switched off. It shares a chip with the Wi-Fi,
  and it was taking the Wi-Fi down with it.
• Half-written files left on your share by a crash are cleaned up.

v0.6.1

Rip your Blu-rays and DVDs straight onto your NAS. One box, one cable, no
babysitting. Download the Preparer, let it write an SD card, plug the box in.

Your computer	Download	Then
macOS	riparr-preparer-macos.dmg	Open it, drag Riparr Preparer into Applications
Windows	riparr-preparer-windows-beta.exe	Double-click it
Linux	riparr-preparer-linux-beta.tar.gz	Unpack it, run Riparr Preparer
Linux on ARM	riparr-preparer-linux-arm64-beta.tgz	Unpack it, run Riparr Preparer

Nothing is code-signed yet, so your computer will block it the first time. On macOS,
double-click it, let it get refused, then go to System Settings → Privacy &
Security, scroll to the bottom and click Open Anyway. On Windows, if
Edge holds the download choose … → Keep → Keep anyway, then Run (or
More info → Run anyway).

Already running Riparr? The box updates itself from System → Updates, and
the Preparer updates itself from the sidebar. You do not need to download
riparr-server.tar.gz or versions.json by hand.

User guide · Which drive to buy

What changed in 0.6.1

Pick your format and quality for music CDs. Settings → Ripping → Music CDs now offers
FLAC, ALAC (Apple Music), WAV, MP3, AAC, Opus and Ogg Vorbis, each with its own quality
choices: MP3 at VBR V0 or V2 or a constant 128 to 320 kbps, AAC from 128 to 320 kbps,
and so on. AAC and ALAC need an extra download of about 150 MB, which the box fetches
by itself the first time you rip in one of them.

"When a disc can't be identified" now covers CDs. Set it to Ask me and a CD nothing
recognises asks for "Artist - Album" instead of being saved as Unknown Album. Skip
leaves it alone. The name you give is remembered if the CD comes back.

A rip never picks up leftovers from an older one. After restoring an older backup
of your settings, a new rip could end up with files from a previous rip mixed into it.

Garbled names on burned CDs are ignored instead of becoming an artist called "?".

v0.6.0

Rip your Blu-rays and DVDs straight onto your NAS. One box, one cable, no
babysitting. Download the Preparer, let it write an SD card, plug the box in.

Your computer	Download	Then
macOS	riparr-preparer-macos.dmg	Open it, drag Riparr Preparer into Applications
Windows	riparr-preparer-windows-beta.exe	Double-click it
Linux	riparr-preparer-linux-beta.tar.gz	Unpack it, run Riparr Preparer
Linux on ARM	riparr-preparer-linux-arm64-beta.tgz	Unpack it, run Riparr Preparer

Nothing is code-signed yet, so your computer will block it the first time. On macOS,
double-click it, let it get refused, then go to System Settings → Privacy &
Security, scroll to the bottom and click Open Anyway. On Windows, if
Edge holds the download choose … → Keep → Keep anyway, then Run (or
More info → Run anyway).

Already running Riparr? The box updates itself from System → Updates, and
the Preparer updates itself from the sidebar. You do not need to download
riparr-server.tar.gz or versions.json by hand.

User guide · Which drive to buy

What changed in 0.6.0

Music CDs. Put a CD in and it comes out as an album in your library: one FLAC per
track, named and tagged from MusicBrainz, with the album cover beside the tracks and
inside each file. Store-bought and burned CDs both work. A burned CD MusicBrainz doesn't
know is named from the names written on the disc, if it has them, and otherwise saved as
"Unknown Album" so nothing gets turned away. A burned data CD full of MP3s is copied
over as it is.

Music has its own place. Settings → Library has a Music row next to Films and
Television, so albums can go to the share your music server reads. Settings → Ripping
has the rest: MP3 instead of FLAC, MusicBrainz on or off, cover art on or off.

A two-CD album lands in one folder, numbered 1-01, 2-01 and so on.

A scratched track costs that track, not the album. The job tells you which track
couldn't be read, and putting the disc back in tries again instead of being refused as a
duplicate.

The box installs its CD tools by itself a couple of minutes after this update. A CD put
in before then waits for them.

v0.5.0

Rip your Blu-rays and DVDs straight onto your NAS. One box, one cable, no
babysitting. Download the Preparer, let it write an SD card, plug the box in.

Your computer	Download	Then
macOS	riparr-preparer-macos.dmg	Open it, drag Riparr Preparer into Applications
Windows	riparr-preparer-windows-beta.exe	Double-click it
Linux	riparr-preparer-linux-beta.tar.gz	Unpack it, run Riparr Preparer
Linux on ARM	riparr-preparer-linux-arm64-beta.tgz	Unpack it, run Riparr Preparer

Nothing is code-signed yet, so your computer will block it the first time. On macOS,
double-click it, let it get refused, then go to System Settings → Privacy &
Security, scroll to the bottom and click Open Anyway. On Windows, if
Edge holds the download choose … → Keep → Keep anyway, then Run (or
More info → Run anyway).

Already running Riparr? The box updates itself from System → Updates, and
the Preparer updates itself from the sidebar. You do not need to download
riparr-server.tar.gz or versions.json by hand.

User guide · Which drive to buy

What changed in 0.5.0

Full disc backups. Settings → Ripping → Titles → Full disc backup keeps the whole
disc instead of one MKV: the VIDEO_TS or BDMV folder with the menus, extras and every
audio track, decrypted. It lands in your Movies folder where the film would have gone.
Jellyfin and Kodi play it as a disc, and you can make an ISO from it later. Blu-rays and
4K discs go through MakeMKV. DVDs use dvdbackup, which installs itself on the box a few
minutes after this update. Until it has, DVDs rip as MKV and the job tells you so.

Raspberry Pi 3, 4 and 5. The Preparer's board list now has the Pi 3 Model A+, 3
Model B, 3 Model B+, 4 / 400 and 5. They won't fit the printed case, but the card setup
is the same as every other board. All marked beta.

Raspberry Pi cards set themselves up again. Current Raspberry Pi OS stopped reading
the settings file the Preparer wrote, so a Pi card booted with no Wi-Fi and no login.
The Preparer now writes the files Raspberry Pi OS actually reads. That fixes the Zero 2 W
too.

The Wi-Fi list matches your board. On a 2.4 GHz-only board (the Pi Zero 2 W and the
Pi 3 Model B) the Preparer greys out networks its radio can't see.

Staged rips keep their year. A film you named with a year, like "Spirited Away
(2001)", lost the year if it was ripped to the card first and sent to your library later.

One thing to know on a Raspberry Pi: adding extra Wi-Fi networks from Settings → Network
isn't supported there yet. The network you set up with keeps working.

v0.4.5

Rip your Blu-rays and DVDs straight onto your NAS. One box, one cable, no
babysitting. Download the Preparer, let it write an SD card, plug the box in.

Your computer	Download	Then
macOS	riparr-preparer-macos.dmg	Open it, drag Riparr Preparer into Applications
Windows	riparr-preparer-windows-beta.exe	Double-click it
Linux	riparr-preparer-linux-beta.tar.gz	Unpack it, run Riparr Preparer
Linux on ARM	riparr-preparer-linux-arm64-beta.tgz	Unpack it, run Riparr Preparer

Nothing is code-signed yet, so your computer will block it the first time. On macOS,
double-click it, let it get refused, then go to System Settings → Privacy &
Security, scroll to the bottom and click Open Anyway. On Windows, if
Edge holds the download choose … → Keep → Keep anyway, then Run (or
More info → Run anyway).

Already running Riparr? The box updates itself from System → Updates, and
the Preparer updates itself from the sidebar. You do not need to download
riparr-server.tar.gz or versions.json by hand.

User guide · Which drive to buy

What changed in 0.4.5

The Linux Preparer works. Before this, it closed the moment you opened it. It now
writes the card, finds the box and installs Riparr, the same as on a Mac or PC. It uses
the GTK and WebKit your desktop already has.

Linux on ARM gets its own download, for Raspberry Pi desktops and ARM laptops.

Cards written on newer Ubuntu boot. Ubuntu 25.10 and later ship a dd that can
write a damaged card while reporting success. The Preparer writes the card itself now,
and its read-back check reads the card rather than a copy in memory.

Setup finds the box faster on busy networks. If your box doesn't answer to its
name, setup goes looking for it by address. On a network with lots of devices that
search could run out of time before reaching the box. It's quicker now, and it tries
the address the box was last seen at first.

Your SD card reader shows up on Linux even when Linux doesn't report it as
removable hardware.

v0.4.4

Rip your Blu-rays and DVDs straight onto your NAS. One box, one cable, no
babysitting. Download the Preparer, let it write an SD card, plug the box in.

Your computer	Download	Then
macOS	riparr-preparer-macos.dmg	Open it, drag Riparr Preparer into Applications
Windows	riparr-preparer-windows-beta.exe	Double-click it
Linux	riparr-preparer-linux-beta.tar.gz	Unpack it, run Riparr Preparer

Nothing is code-signed yet, so your computer will block it the first time. On macOS,
double-click it, let it get refused, then go to System Settings → Privacy &
Security, scroll to the bottom and click Open Anyway. On Windows, if
Edge holds the download choose … → Keep → Keep anyway, then Run (or
More info → Run anyway).

Already running Riparr? The box updates itself from System → Updates, and
the Preparer updates itself from the sidebar. You do not need to download
riparr-server.tar.gz or versions.json by hand.

User guide · Which drive to buy

What changed in 0.4.4

The Preparer works on Windows, start to finish. It writes the Orange Pi card, finds
the box on your network and installs Riparr on it, the same as on a Mac. Windows will
warn you that the app isn't commonly downloaded and that its publisher is unknown. It's
unsigned; choose Keep, then Yes.

No more hanging at 100%. After checking a freshly written card, the Preparer could
sit on "Checking the card" forever even though the card was done. That happened on Macs
too. It now moves straight on to the next step.

Fresh installs start properly. A new box could fail its first start with a
"readonly database" error. It doesn't any more.

The window fits the screen on Windows, at any display scaling, and the wording talks
about your PC rather than a Mac.

v0.4.3

Rip your Blu-rays and DVDs straight onto your NAS. One box, one cable, no
babysitting. Download the Preparer, let it write an SD card, plug the box in.

macOS	riparr-preparer-macos.dmg	Open it, drag Riparr Preparer into Applications
Windows	riparr-preparer-windows-beta.exe	Double-click it
Linux	riparr-preparer-linux-beta.tar.gz	Unpack it, run Riparr Preparer

Nothing is code-signed yet, so both will block it the first time. On macOS,
double-click it, let it get refused, then go to System Settings → Privacy &
Security, scroll to the bottom and click Open Anyway. On Windows,
More info → Run anyway.

Already running Riparr? The box updates itself from System → Updates, and
the Preparer updates itself from the sidebar. You do not need to download
riparr-server.tar.gz or versions.json by hand.

User guide · Which drive to buy

What changed in 0.4.3

The Windows Preparer can put MakeMKV on the card. With the MakeMKV download in your
build folder, writing a card on Windows failed unless you were an administrator or had
Developer Mode on. It now works for everyone.

v0.4.2

Rip your Blu-rays and DVDs straight onto your NAS. One box, one cable, no
babysitting. Download the Preparer, let it write an SD card, plug the box in.

macOS	riparr-preparer-macos.dmg	Open it, drag Riparr Preparer into Applications
Windows	riparr-preparer-windows-beta.exe	Double-click it
Linux	riparr-preparer-linux-beta.tar.gz	Unpack it, run Riparr Preparer

Nothing is code-signed yet, so both will block it the first time. On macOS,
double-click it, let it get refused, then go to System Settings → Privacy &
Security, scroll to the bottom and click Open Anyway. On Windows,
More info → Run anyway.

Already running Riparr? The box updates itself from System → Updates, and
the Preparer updates itself from the sidebar. You do not need to download
riparr-server.tar.gz or versions.json by hand.

User guide · Which drive to buy

What changed in 0.4.2

Riparr reads the key from makemkv.com itself. While GuinpinSoft isn't selling
licences, its purchase page publishes the current beta key, and that is now the first
place Riparr looks. It is their own site and it answers in about a second. The backup
key service is asked alongside it for the expiry date and as a second opinion, and the
forum, which can take minutes, only when those two don't settle it. Riparr renews a key
by itself only when makemkv.com or its forum stands behind it.

No Buy button when there's nothing to buy. When makemkv.com isn't selling licences,
the renewal message says so, and that their site asks everyone to use the free key for
now. When sales reopen, the Buy button comes back.

No more false "The install stopped unexpectedly". Installing or upgrading MakeMKV
could show that for a moment while it was working fine, and the page stopped following
the build. It no longer does.

v0.4.1

Rip your Blu-rays and DVDs straight onto your NAS. One box, one cable, no
babysitting. Download the Preparer, let it write an SD card, plug the box in.

macOS	riparr-preparer-macos.dmg	Open it, drag Riparr Preparer into Applications
Windows	riparr-preparer-windows-beta.exe	Double-click it
Linux	riparr-preparer-linux-beta.tar.gz	Unpack it, run Riparr Preparer

Nothing is code-signed yet, so both will block it the first time. On macOS,
double-click it, let it get refused, then go to System Settings → Privacy &
Security, scroll to the bottom and click Open Anyway. On Windows,
More info → Run anyway.

Already running Riparr? The box updates itself from System → Updates, and
the Preparer updates itself from the sidebar. You do not need to download
riparr-server.tar.gz or versions.json by hand.

User guide · Which drive to buy

What changed in 0.4.1

The MakeMKV key renews itself. The free beta key runs out at the end of every month,
and until now a box stopped reading discs until somebody pasted in the new one. Riparr
now checks every six hours and, when GuinpinSoft publishes the next key, puts it in for
you. It only ever swaps a beta key for a beta key: a bought key is never touched, and if
the forum and the backup source disagree about the new key, nothing changes. You can
turn this off in Settings → General.

The next time you open the web page after a renewal, Riparr tells you once, along with a
link to buy MakeMKV. Riparr reads discs because of MakeMKV, and buying a licence is how
the people who make it get paid. A bought key also never runs out. Dismiss the message
and it stays away until the next renewal.

MakeMKV 2.0.0, and a way to upgrade to it. New boxes install 2.0.0. A box that
already has an older MakeMKV shows MakeMKV 2.0.0 is available under
System → Updates and Settings → General, with one button to upgrade. The build
runs on the box and takes about half an hour. The version you have keeps working until
the new one has finished building, and a disc going in while it builds is asked to wait.

Installing MakeMKV from the web page works on every box. It used to work only if the
Preparer had put the MakeMKV download on the card. Without it, the box had nothing to
download and gave up.

The Preparer only copies the MakeMKV version the box will install. An older download
in your build folder is left off the card instead of being copied and ignored. When it
finds a box that is already running, it also says if that box's MakeMKV or key is out of
date.

v0.4.0

Rip your Blu-rays and DVDs straight onto your NAS. One box, one cable, no
babysitting. Download the Preparer, let it write an SD card, plug the box in.

macOS	riparr-preparer-macos.dmg	Open it, drag Riparr Preparer into Applications
Windows	riparr-preparer-windows-beta.exe	Double-click it
Linux	riparr-preparer-linux-beta.tar.gz	Unpack it, run Riparr Preparer

Nothing is code-signed yet, so both will block it the first time. On macOS,
double-click it, let it get refused, then go to System Settings → Privacy &
Security, scroll to the bottom and click Open Anyway. On Windows,
More info → Run anyway.

Already running Riparr? The box updates itself from System → Updates, and
the Preparer updates itself from the sidebar. You do not need to download
riparr-server.tar.gz or versions.json by hand.

User guide · Which drive to buy

What changed in 0.4.0

TV box sets work. Put a season disc in and Riparr rips every episode on it, in
order, numbered and named — instead of ripping one file and quietly discarding the rest,
which is what it did before.

Six titles of about the same length is a season disc, not a film with five decoys.
Riparr finds the episodes, throws out the "play all" title and the duplicate playlists
most discs carry, and works out what order the episodes go in.

The order comes from the disc. Most Blu-ray season discs carry a hidden "play all"
playlist, and it is the disc's own record of what order its episodes go in — so when
it's there, the order is a fact, not a guess, and Riparr gets it right without asking.
When it isn't there, Riparr falls back to the disc's playlist numbering and shows you
the plan before it rips anything.

Episode names come from TVmaze, which needs no account and
no API key.

Disc order and broadcast order don't always agree, and Riparr always keeps the
disc's. Firefly is the famous case — the disc opens with "Serenity", which aired second.
Riparr takes the sequence from the disc and only the names from the lookup, so you see
the disagreement on the plan, before anything is written, rather than a year later.
Changing first episode renumbers and renames the whole disc in one move.

Correct the first disc of a season and the rest follow. Riparr shows you the plan
once per season, on the first disc; disc two carries on from where disc one stopped with
nothing to answer.

The episode plan is a table, one row per file that will be written. Untick a duplicate,
move an episode with the arrows, type over a name, change where the numbering starts —
the numbers update as you go, so what's on screen is what will be written.

New settings under Settings → Ripping → Television: whether to look for season discs
at all, when to stop and show you the plan (the default asks only when Riparr isn't
sure), whether to look up episode names, and where specials go.

The naming templates fill {Season:00}, {Episode:00} and {EpisodeTitle}, which
the settings page has listed as "not yet" since the first release. A double-length
premiere or finale becomes S01E01-E02 on its own, which is what Plex and Jellyfin read
as one file holding two episodes.

Two things a season disc can do that Riparr still can't. A season welded into a
single four-hour title gets ripped as one file — Riparr says so, but splitting it needs
MKVToolNix on another machine. And nothing here reads production or DVD ordering; the
disc's own order is what you get, which is usually what you want from a disc.