FerrumPix is a desktop photo manager and image editor for Linux and Windows, with experimental ARM64 and macOS builds. Browse your folders, sort and rate what is in them, look at photos properly, and edit them - all in one application, all on your own machine. It can also connect to a self-hosted Immich or Nextcloud server.
It is built with Avalonia UI and .NET 10, in VB.NET, which I still love even though it is rare nowadays. This started as a private project - an application built exactly the way I always wanted one to look and work - and it is free and open source for anyone who finds it useful.
To be transparent: yes, I use AI to support my development workflow. AI helps me also with translation. However, it still requires a massive amount of manual work, architecture planning, and debugging. I am currently investing a lot of time. A ton of passion, unique ideas, and genuine hard work went into this project.
I wanted a fast, native desktop app for my whole photo workflow, without being locked into a big ecosystem or jumping between four programs.
Most tools in this space are good at one thing. Photo library apps organise, rate and tag well but edit only a little. RAW converters are excellent at tone and colour, and stay purely parametric. Pixel editors can do almost anything to a single image but have no real library. Immich and Nextcloud store and share photos beautifully, but they live in the browser.
FerrumPix closes those gaps. It puts photo management, non-destructive RAW development, pixel editing, local folders and direct access to Immich and Nextcloud into one native application. Browse, rate and tag your library, open a photo for non-destructive adjustments, go down to the pixel when you need to, and work with your own server alongside your local folders.
It runs on Windows, Linux and macOS, stays fast and local-first, and is built for hobby photographers and enthusiasts rather than studio pipelines. It does not care whether you feed it RAW files from a camera or JPEGs from your phone.
- Browse local photo folders with fast thumbnails, ratings, favourites, keywords and saved searches.
- View photos and videos fullscreen, compare two side by side, and check metadata and histogram.
- Edit: crop, resize, rotate and distort, exposure and colour, curves, filters, masks, retouching, text and shapes, layers.
- Develop RAW files from the sensor data, the small JPEG XL compressed DNGs included, with lens correction from measured data for more than 1500 lenses.
- Run batch work over a whole selection: rename, convert, resize, watermark, filters, metadata, export.
- Open JPEG, PNG, WEBP, JPEG XL, TIFF, BMP, GIF and RAW, plus HEIC/HEIF/AVIF read-only, and Photoshop files with their layers.
- Hand a picture to another program with Open with, and pass it through G'MIC from the editor if you have it installed.
- Find the people in your photos and search by them, and search by where a photo was taken - both entirely on your own machine. If you switch it on, a map shows where your photos were taken.
- Connect to your own Immich or Nextcloud server for browsing, upload, download, editing and metadata sync.
- Use FerrumPix in a web browser: let it run on the computer where your photos are and work with it from the sofa.
- Work in your own language: twenty-one are built in, and the symbol search finds shapes by their name in each of them.
Your originals are never changed behind your back, and nothing at all is written until you save. Saving a RAW or a Photoshop file puts your edits in a small sidecar beside it, because those two are never written to; everything else is written the way you asked for it. For a RAW file that sidecar can hold several variants of the edit, say one in colour and one in black and white. Each variant is a picture of its own in the gallery, with its own rating and keywords, and is exported on its own.
Folder tree, grid, list, group view, photo wall and map view, fast thumbnails, file operations, ratings, favourites, keywords and saved searches. A folder can show the pictures from all its subfolders as well. Search combines plain text with metadata such as camera, ISO, aperture, focal length, date taken, image size, title, description, creator, place and copyright.
The group view puts a heading above each block of pictures, following whatever you sort by: one block per day when sorting by date, or by month or year, and by name, camera, file type or rating just as well. A circle in front of the heading selects a whole block at once.
If you switch it on in Settings, bursts and RAW+JPEG pairs are stacked: shots taken in quick succession, and the JPEG the camera wrote next to a RAW, show up as one thumbnail. A click on a burst shows just that burst, shot by shot, until you go back to the folder; that is also where its pictures are deleted, one at a time, never the whole burst at once. Within a burst the sharpest shot moves to the front and every shot gets a small sharpness bar, so culling a series is a matter of keeping the best and pressing SHIFT+X to reject the rest. Rejected pictures stay where they are, dimmed, until you hide them with the filter or delete them yourself.
Show similar pictures in the filter menu gathers the near duplicates of a folder into groups, such as the shots of a series or the same subject taken twice, with a sharpness bar on each picture and the sharpest one marked. Three levels decide how close "similar" has to be. It works on the pictures themselves, without an AI model.
Import in the sidebar copies pictures and videos from a memory card or any other folder. Pick the shooting days you want and a destination: the current folder, or one of your own destinations from the settings, which can sort pictures into folders by the year, day or camera they were taken with. A second folder can take a backup at the same time. Every copy is checked against the original before it gets its name, nothing on the card is touched, and nothing already in the destination is replaced; pictures that are already there are simply skipped.
The photo wall lays the pictures out edge to edge in their own proportions, without captions; its gap is adjustable, and rounded corners and frames can be turned off.
A map view shows the pictures by where they were taken. It is off until you switch it on in Settings, because the map itself comes from a tile server on the internet, which learns which area you are looking at. The photos themselves never leave your machine, and map tiles you have seen are kept there until you clear them.
Ratings, colour labels, keywords and reject marks are read from the sidecars Lightroom, darktable or digiKam write, so a collection you tagged elsewhere arrives with its work intact. Point FerrumPix at a Lightroom Classic catalog and it reads that too, including titles, captions and the edits of your RAW files; the catalog itself is never changed. Keywords stored inside the picture itself, in its IPTC or XMP data, are picked up as well and can be searched like any other keyword. From the catalog FerrumPix also takes copyright, location and capture times you corrected there, wherever the picture itself does not say otherwise.
If you like, the keywords you add go into JPEG, PNG and WebP files themselves too, as XMP, IPTC or both, when you add them and when you save or export; keywords found by the AI recognition always stay in FerrumPix.
When file and catalog have drifted apart, a side-by-side comparison shows both for one picture and lets you copy or remove single values in either direction. Rating, label, pick mark and keywords can also be taken from the files into the catalog, or written from the catalog into the files and sidecars, for a whole selection.
Title, headline, description, creator and credit line can be set for one picture or a whole selection. JPEG, PNG and WebP carry them inside the file, other formats such as RAW in an XMP sidecar and, for RAW and Photoshop files, in FerrumPix's own sidecar as well, and an export takes them along. They are read from the pictures as well, so search and saved searches find them, and the info sidebar can show them if you switch them on.
Name the folders your photos live in and they appear at the top of the folder tree, one click away, and FerrumPix reads them in the background, subfolders included, so search and filters can cover your whole collection instead of only the folders you happened to open. It runs shortly after startup if you want it to, and it can be stopped at any time. Later runs only look at what has changed, and nothing is ever written next to your photos. Renaming or moving a folder in FerrumPix takes its ratings, labels, keywords, people and thumbnails along; if you moved it outside FerrumPix, you can point the settings at its new location.
One list in the settings shows every folder FerrumPix knows, grouped under the ones you watch. Search it, then clean up the catalogue data or the thumbnails of whatever the search leaves, or send the people search over them - on a whole tree or on a single folder.
An info sidebar shows the selected picture with its shot data, histogram, rating, label and keywords; with several selected it shows what they have in common and lets you set them all at once. You pick what it shows - camera, lens, aperture, shutter speed, ISO, focal length, the date the picture was taken, the technical facts about the file, and whether rating, label and keywords appear at all.
Photos can be filtered by keyword, by person and by where they were taken, alone or in combination. One button next to the search field decides whether search and filters look at the open folder or at your whole catalogue. FerrumPix finds the people in your photos, groups them, and you give each group its name; the names are stored beside the picture, so they stay with the photos. In the sidebar, names the recognition only suggested look different from the ones you set or confirmed. A people area of its own shows a wall of faces for sorting out a library that grew over years.
Photos without a location can be given one: type a coordinate or just a town name, or copy the place from a picture that already has it and paste it onto the rest. JPEG files carry it inside the file, everything else in a sidecar next to the original. The town search runs on your own machine.
If you had a GPS track running - on a phone, a watch, a logger - the whole selection can take its places from that instead. FerrumPix reads the GPX file and gives every photo the spot the track was at when the picture was taken. You confirm how far the camera clock is from the recording, and the dialog counts along and tells you how many photos that reaches before anything is written.
The time a picture was taken can be corrected the same way. Set a date and time outright, or shift what is already there by days, hours, minutes and seconds - for the trip where the camera clock was wrong and every photo is off by the same amount. Whole selections at once, and the file's own date follows along.
Batch work runs over a whole selection: rename, convert, resize, watermark, adjustments, metadata removal, and Export to for putting a name pattern, a look, a size and a target format into one run, locally or straight to Immich. Converting JPEG files to JPEG XL can repack them without any loss, so the original JPEG can be restored exactly. Converting can also turn RAW files into DNG, keeping them raw instead of rendering them out; that one needs dnglab installed, and says so if it is missing. Photos can also be printed, laid out as contact sheets or combined into a collage, each showing your edits.
Target folders and file names can come from your own templates, in batch work as in Save as: {folder}/export puts every result into a subfolder next to its picture.
Fullscreen viewing with zoom, pan, a slideshow you can pause and zoom into, a filmstrip on any side of the picture, rating, tagging and deleting, and an info panel with EXIF, IPTC, XMP, ICC and a live histogram. Videos play inline.
A RAW file opens from the preview the camera put inside it, which is why it appears at once. Two settings change that: one develops a RAW you have already edited, the other develops every RAW, edited or not, in the viewer and in fullscreen. You then see your own development instead of the camera's rendering, and wait a little longer for it. The viewer, the quick preview and the comparison develop at half resolution so you can step through quickly; full resolution can be switched back on in the settings.
The info panel reads a picture in three ways: the histogram, with all colour channels at once or one channel or the luminance alone, a waveform that keeps the left-to-right position so you can see whether one side burns out while the other still holds detail, and an RGB parade that puts the three channels side by side to show a colour cast and which channel carries it. A click opens the diagram large, and in the editor it follows your edits.
Two photos can be put side by side for comparison, sharing one zoom so you always see the same part of both. Pin one of them and page through the rest against it, rating and deleting as you go, which is the quick way to cull a series. RAW files are developed here rather than shown as the camera's embedded preview.
Geometry. Crop, resize, rotate, flip and canvas size, plus five ways to distort a picture: perspective, a line you lay on an edge and drag, a grid, a frame whose edges you bend, and a liquify brush that pushes, bloats, puckers or twirls. None of them is computed into the pixels, so they can be adjusted or taken off at any time, and with an object selected they distort that object instead.
Two of them can find their own setting. Level to the horizon looks for the straight edges in the picture - the horizon, the edge of a house, a row of windows - and turns the photo until they sit level; Correct perspective automatically finds the verticals of a building shot that lean together and pulls them upright. Both put their result on the ordinary sliders, to be nudged afterwards like a value you set yourself, and both say so when the picture already stands right. Straightening can trim the empty corners away on its own, and the perspective can fill the frame on its own. To straighten by hand, draw a line along an edge that should be level or upright, and the picture turns to match.
Light and colour. Exposure, contrast, highlights, shadows, black and white point, white balance, tone curves, HSL, point colour (pick one colour in the photo and shift only that), vibrance and saturation, colour grading with four colour wheels, camera calibration, a channel mixer and a gradient map. On RAW files, exposure reads in stops and white balance in Kelvin, with an eyedropper for a neutral spot. Highlights and shadows work on the brightness of the surroundings, so pulling back a bright sky brings out its structure instead of flattening it. A clipping warning shows where highlights or shadows run out. Auto sets a sensible starting point, and a set of slider values can be saved and put on any other photo.
Details and effects. Clarity, structure, dust and scratches, sharpening, blur and four kinds of noise reduction. Sharpening can reverse the blur instead of drawing halos along the edges, and noise reduction smooths each part of the picture by how noisy it really is. Depth blur takes its strength from how far away each point is, so lights in the background open into bright discs. Depth fog uses the same distance to build up haze like real fog, a little in front and the most far away. Vignette, grain, tilt-shift, posterize, threshold and frame sit in a separate Effects tool, where the grain can also be coloured: a slider lets the three colour channels drift apart, from plain grey grain to the coloured speckles of a fast film.
Masks and selections. Rectangle, ellipse, lasso and magic wand selections, a soft-edged mask brush whose strokes can cover fully or only in part, and graduated and radial masks you drag onto the picture. You can also select by colour - click one and everything close to it comes along - or by brightness, taking just the deep shadows or everything above a certain lightness. Clicking a person or an object picks it out on its own. One mask can be built from several parts, each added, subtracted or intersected and changeable afterwards, and any of them becomes a layer whose adjustment applies only inside it. A mask can be looked at on its own, switched off, copied onto another layer, or put aside and pasted back later. Refine edge lets the edge of a selection or mask follow hair, fur and fine twigs instead of cutting them off. A selection can be expanded, contracted, smoothed or turned into a border, and its edge can be stroked with a line that stays adjustable, the same stroke the objects have.
The pen. Draw a curve point by point and change it at its points afterwards. One button turns it into a selection, so a cut-out stays correctable. A path draws nothing until you give it a stroke or a fill, and text can follow one.
With a model file installed (see below), four more things become available: clicking an object to select it, selecting by distance from the camera, removing something so the background is continued through the gap (on the photo or inside a marked layer), and denoising a photo with a model, which can measure the noise itself and pick the strength. Raw files are denoised before exposure and colour, so they stay raw files. Applying a filter to a selection can denoise each picture along the way and leaves clean ones alone.
Retouching and painting. Brush, an image brush that erases, dodges, burns, saturates or desaturates, replaces colors or paints the original picture back, blur and smudge, clone stamp and repair brush, with thirteen brush variants, pen pressure, stroke smoothing and red eye removal. A selection keeps them inside it, and with a picture layer selected they work on that layer instead of on the photo. An empty layer to paint on is one click away in the layers panel, its transparent pixels can be locked so strokes stay inside what is already there, and CTRL-clicking a layer thumbnail loads its shape as a selection.
Objects and layers. Text, shapes, symbols, images, QR codes and watermarks, each with opacity, blend mode, fill, stroke, shadow, glow and transform; shadow and glow can lie outside, inside or both; a fill can be a solid colour or a gradient of as many colours as you like, linear, radial, angled, reflected or diamond shaped, picked from ready-made gradients or saved as your own; a stroke can sit inside, centred or outside the edge, fade out softly and have round or sharp corners, text set left, centred, right or justified, and text that follows an arc, a circle or a wave. Any of them can carry a mask or be clipped to the layer below, and an adjustment placed above an object can be held to that object the same way. A picture comes in as a layer by dragging it onto the photo, either from the editor's filmstrip, which you can browse freely without leaving the picture you are working on, or from your file manager, or by pasting it from the clipboard. The layers panel holds the whole stack with visibility, order, grouping, merging, rasterizing, flattening into the photo, trimming away a transparent border and making a plain background transparent (also of the photo itself, from the right-click menu), and layers can be copied and pasted, also from and to other programs. Several layers selected together can be aligned to each other or to the picture and spread out evenly. A group counts as one layer, with its own opacity, blend mode and mask, and groups can go inside groups. The panel has a second tab with the history of the picture: every step by name, from the original onwards, and clicking one takes the picture back to it. The list belongs to the session at hand; close the picture and what you saved comes back, but not the road you took to it.
Filters and presets. Filters, ready-made looks built only from ordinary sliders so they stay editable, LUT files (.cube) and XMP presets as written by Lightroom and Camera Raw. All of them, and the slider sets you saved yourself, can also be applied to a whole selection at once; on raw files that simply updates their edits instead of writing new files. With G'MIC installed, the footer menu hands the picture to its filter window, the context menu of a layer hands over just that layer, and the result comes back as a layer.
Saving. Save as JPEG, PNG, WEBP, JPEG XL, TIFF or PDF, as a Photoshop file with the layer stack intact, or as an .fpx project that keeps adjustments and layers editable when you open it again. CTRL+P prints what you see, edits included.
RAW files are developed from the actual sensor data: a photo keeps the exposure it was taken with, colours land close to what other raw developers show, and coloured speckle is cleaned up along the way. A blown sky can get its detail back from the raw data, and a setting starts unedited RAW files with colours matched to the camera model.
The compare button in the editor can also show the JPEG the camera stored inside the raw file, so you see where the development differs from the camera's own look of the same shot.
To see what a single slider does, right-click it: it jumps to its default and changes colour, and the next right-click brings your value back. Several sliders can be compared like this at once. The eye in the heading of a group such as Light or Color does the same for all of its sliders together. On request, sliders with a colour meaning such as temperature or tint show where they lead as a colour gradient.
Lens defects are corrected from measured data covering more than 1500 lenses on over 1000 camera bodies: distortion, coloured fringes and the darkening towards the edges. Lens and camera are recognised from the shot data, compact cameras with their built-in lens included. For Sony, Olympus, OM System and Panasonic cameras without measured data, the correction the camera stores in the raw file is used instead, and where there is nothing for your lens, nothing is changed. Coloured fringes the measured data leaves behind, or those of a lens without data, can be removed by hand.
Save a RAW and your edits go into a small sidecar next to it; the RAW itself is never modified, and opening the photo again brings the edits back. Save it as a JPEG or a PNG instead and you get that one file, with the edits baked in and no sidecar. A Lightroom sidecar with develop settings is converted once, so a photo edited elsewhere opens the way you left it.
A picture that carries its own colour profile, such as Adobe RGB or Display P3, is converted when it is opened, so it looks the way it was meant to instead of flat and shifted. That covers JPEG, PNG, WEBP, TIFF, Photoshop files, HEIC and JPEG XL. Pictures without a profile are left exactly as they are, and what you save is sRGB and says so. On macOS, the colours are also matched to the screen you are using. On Windows and Linux you can set an ICC profile for each display, and photos are matched to the display the window is on.
Pictures from a phone or a scanner open too, and your edit is saved as a new file next to them. A Photoshop file keeps its layers, masks and groups, so a picture can go back to Photoshop, Affinity or GIMP and still be worked on there, and text stays text you can keep typing on. Photoshop files that FerrumPix cannot take apart open as one finished picture.
Eight features use an extra file: selecting an object by clicking it, working by distance, removing an object, denoising, enlarging with a model, finding the people in your photos, automatically tagging image contents, and turning coordinates into a place name. The settings have a Models section that fetches each file on request, and a function whose file is missing asks whether to download it the first time you use it. Finding people, automatic image tagging and naming places have to be switched on there as well.
Enlarging offers five models, from twice to four times, thorough or quick, one that keeps the grain and one for drawings, right in the image size tool of the editor. A switch in the same section lets the graphics card do the work, which finishes several times sooner with the same result.
Everything runs on your own machine - nothing is sent anywhere. The files come from MobileSAM (Apache-2.0), MiDaS (MIT), LaMa (Apache-2.0), RawForge (MIT, trained on RawNIND, CC BY-SA 4.0), NAFNet (MIT), Real-ESRGAN (BSD-3-Clause), the OpenCV Model Zoo (MIT and Apache-2.0) and GeoNames (CC BY 4.0), collected with their licences at FerrumPix-Models. Automatic image tags use RAM++ (Apache-2.0), fetched straight from its publisher. It is the largest of the files, so give it a moment. The one that compares faces is fetched straight from its publisher, the ONNX Model Zoo: its weights come from InsightFace, which limits them to non-commercial research, so it is not passed on with the others.
FerrumPix can connect directly to a self-hosted Immich server: browse all photos and albums, upload local files, download originals, sync ratings, favourites and keywords, search from saved search lists, and edit an Immich photo and save the result as a new asset. Updating or deleting existing assets is possible too, but has to be enabled in Settings.
The people your server recognised and the cities it knows appear in the same filter buttons as the local ones, under a heading of their own. Deleted photos are listed under Trash and can be put back from there.
FerrumPix authenticates with an API key. A key with all works; if you prefer a restricted one, build it up in layers - each missing permission disables exactly one function instead of breaking the integration:
Read-only - browse, view, download:
user.read asset.read asset.view asset.download asset.statistics album.read person.read tag.read
Add for writing metadata - ratings, favourites, description, keywords:
asset.update tag.create tag.asset
Add for uploading - upload from the gallery, and saving an edited photo as a new asset:
asset.upload albumAsset.create asset.copy
Plus album.create and album.update if FerrumPix should create and rename albums, and asset.delete with album.delete if Allow deleting is on. Immich also asks for asset.delete to put photos back from Trash.
Update existing assets replaces the file of an existing asset, and the permission for it is named differently across Immich versions. Left off, FerrumPix always creates a new asset instead.
A Nextcloud can be used as a second server: your timeline, albums, people, places and keywords appear as folders in the gallery, photos open in the viewer and the editor, and deleted ones are listed under Trash and can be put back from there.
The Memories app is not required. Without it FerrumPix builds the timeline from the server itself, and albums, keywords, favourites, the trash and the search work just the same; people are the one thing Memories brings along, and that branch simply stays away.
Because Nextcloud keeps your photos as files, more is possible here than on an Immich server. A RAW on the server can be edited without touching it: saving puts the recipe in a sidecar file next to the original, and it is picked up again the next time you open the photo. If you would rather have the edit written into the file itself, Replace originals on the server does that - the file keeps its identity, its albums and its shares. RAW and PSD files are never overwritten either way.
Local pictures can be uploaded by dragging them onto a Nextcloud entry, by pasting, or from the right-click menu; they go to the folder set in Settings and an existing name is numbered rather than overwritten. Keywords, favourites and album assignments are written back to the server; stars and colour labels stay local, as Nextcloud does not know them.
FerrumPix signs in with your user name and an app password, which you create in Nextcloud under Settings, Security. Deleting on the server has to be enabled in Settings; deleted photos go to the Nextcloud trash, unless you also switch on Delete for good.
Sometimes the photos live on one computer and you would rather sit at another. Maybe they are on a small server in the hallway that has no screen at all, or on the big machine in the study while you are on the sofa with a laptop. For that, FerrumPix can show itself in a web browser instead of in a window.
It is the same FerrumPix with everything it can do, gallery, viewer and editor. Nothing is installed on the device you sit at; a browser is enough. The pictures stay where they are, and all the work happens on the computer FerrumPix runs on.
To try it on your own computer, start FerrumPix with --browser:
ferrumpix --browser
ferrumpix, in lowercase, is the command the Linux packages install. The AppImage is started by its file name, and on macOS the app is opened with its arguments behind --args:
./FerrumPix-0.9.84-1-x86_64.AppImage --browser
open -a FerrumPix --args --browser
Everything that follows works the same way with each of them.
No window opens. FerrumPix tells you the address instead, http://127.0.0.1:14500, and when you open it, FerrumPix fills the browser tab. Close the tab and come back later, and everything is as you left it.
Leave the terminal open while you use it. FerrumPix runs in that terminal, and closing it ends FerrumPix; the page in the browser then stops reacting.
If you want a sign-in in front of it, give it a password, and a user name if you like. The browser then asks for them before it shows anything:
ferrumpix --browser --browser-user=anna --browser-password=secret
To reach it from another device, such as a tablet or a laptop in the same network, one more thing is needed. FerrumPix does not encrypt the connection itself, and a password travelling through the network unprotected could be read by anyone listening. So it only lets other devices in through a reverse proxy that provides HTTPS, the kind of small web server many people already run in front of their home services. Tell FerrumPix that the proxy is there, and a password becomes mandatory:
ferrumpix --browser --browser-tls-proxy --browser-user=anna --browser-password=secret
If you start it for other devices without that, FerrumPix does not start and tells you why. That is on purpose: it is better to be told once than to find out later that your password was readable.
Everything you can pass on the command line can also come from the environment, which is handy for a service or a container and keeps the password out of the list of running programs:
env FERRUMPIX_BROWSER_USER=anna FERRUMPIX_BROWSER_PASSWORD=secret ferrumpix --browser
If you installed FerrumPix from Flathub, it works the same way. What you would write after ferrumpix goes at the end of the Flatpak command, and settings from the environment are handed in with --env:
flatpak run io.github.bitpainter75.ferrumpix --browser
flatpak run --env=FERRUMPIX_BROWSER_USER=anna --env=FERRUMPIX_BROWSER_PASSWORD=secret io.github.bitpainter75.ferrumpix --browser
| On the command line | In the environment | What it does |
|---|---|---|
--browser |
shows FerrumPix in the browser instead of a window | |
--browser-bind=127.0.0.1:8080 |
FERRUMPIX_BROWSER_BIND |
the address and port to listen on |
--browser-user=anna |
FERRUMPIX_BROWSER_USER |
the user name for the sign-in |
--browser-password=secret |
FERRUMPIX_BROWSER_PASSWORD |
the password for the sign-in |
--browser-tls-proxy |
FERRUMPIX_BROWSER_TLS_PROXY=1 |
a reverse proxy with HTTPS stands in front |
--browser-proxy-address=192.168.1.2 |
FERRUMPIX_BROWSER_PROXY_ADDRESS |
where that proxy is, if it runs on a different computer |
This is a first version, and a few things are still missing. Copy and paste stay inside FerrumPix and do not reach the clipboard of the device you sit at. Videos play without sound. Pictures cannot yet be uploaded from or downloaded to that device. And because the computer draws everything without the help of its graphics card in this mode, it feels a little less quick than the window does, mostly with very large browser windows.
Theme, accent colour, which side the window buttons sit on, language, date format, interface and font scale (on Linux per display), thumbnail and export quality, metadata handling, video support, the map view, cache cleanup and the connection to an Immich or Nextcloud server. A search field finds any setting by a word of its name or description.
The interface speaks German, English, Dutch, Swedish, Danish, Norwegian, Finnish, Spanish, French, Italian, Portuguese, Polish, Czech, Russian, Turkish, Hindi, Thai, Indonesian, Chinese, Japanese and Korean. By default it follows your system; anything else it does not know falls back to English.
Gallery and editor can be set up to match how you work: what a double-click opens, which details appear under a gallery tile, which tool the editor starts with, the order of the tool bar, which side the adjustment panel sits on, whether its scroll bar is always shown and whether it offers buttons to step to the next tool, whether the bottom bar is shown in gallery, viewer and editor, a default format for saving, which adjustment groups you want to see at all, and a compact mode that puts all adjustments into one panel. RAW development has its own settings: the base brightness per camera model, the lens correction, and which method turns the sensor data into a full picture (AHD, DCB or PPG).
A drawing tablet setting makes buttons and menu entries act the moment the pen touches down instead of when it lifts, for pens that can drag a slider but press nothing. A trackpad mode adds gestures for laptops: pinch to zoom in the viewer, swipe to the next picture, and drag to move around an enlarged one.
The catalogue with ratings, keywords, people and places, the settings, favourites and saved searches can be backed up into a ZIP file and restored, each part on its own; server passwords only go in if you want them to.
File operations stay inside your home folder unless you allow them elsewhere, on other drives, mounted media and network folders; system folders stay locked either way.
Your version is at the top, with a link to the download page when a different one has been published; a newer version is also pointed out next to the logo. The last two sections are reference: all keyboard and mouse shortcuts, and everything FerrumPix is built on with a link to each licence.
All packages are in the latest release. Every file name carries the build number, for example FerrumPix-0.9.50-2-x86_64.AppImage; the tables say which ending belongs to which package.
| Package | For | File ends in |
|---|---|---|
| Flathub | Any distribution, installs and updates through Flatpak (x64, ARM64) | FerrumPix on Flathub |
| AppImage | Any distribution, runs without installing | -x86_64.AppImage |
| DEB | Debian, Ubuntu, Mint (amd64) | -amd64.deb |
| RPM | Fedora, openSUSE (x86_64) | -x86_64.rpm |
| ZIP | Portable, unpack and run (x64) | -linux-x64.zip |
| ZIP | Portable, unpack and run (ARM64) | -linux-arm64.zip |
On Arch and its derivatives there is ferrumpix-bin in the AUR.
The AppImage carries update information, so tools that manage AppImages find new versions on their own.
| Package | For | File ends in |
|---|---|---|
| Microsoft Store | Installs and updates through Windows (x64) | FerrumPix in the Microsoft Store |
| Setup | Installs with start menu entry and file types (x64) | -win-x64-Setup.exe |
| ZIP | Portable, unpack and run (x64) | -win-x64.zip |
| ZIP | Portable, unpack and run (ARM64) | -win-arm64.zip |
| Package | For | File ends in |
|---|---|---|
| App bundle | Intel Macs | -osx-x64-unsigned.app.zip |
| App bundle | Apple Silicon | -osx-arm64-unsigned.app.zip |
The macOS builds are unsigned, so macOS blocks them the first time with "FerrumPix" Not Opened. That does not mean the ZIP is broken. You only have to allow it once:
-
Download the right build: arm64 for Apple Silicon (M1, M2, M3, M4), x64 for Intel Macs.
-
Unzip it and move FerrumPix to Applications.
-
Open FerrumPix. macOS says it could not verify the app; click Done.
-
Open System Settings, go to Privacy & Security and scroll down to Security. Next to "FerrumPix" was blocked to protect your Mac, click Open Anyway.
-
Open FerrumPix again and click Open Anyway in the question that follows, then confirm with your password or Touch ID.
From then on FerrumPix starts like any other app.
If macOS instead says the app is "damaged", open Terminal and run:
xattr -dr com.apple.quarantine /Applications/FerrumPix.app
The macOS packages are currently unsigned and should still be considered experimental.
Code signing and notarization require an Apple Developer account and come with an ongoing cost. Since FerrumPix is currently a free, non-commercial project and does not generate any revenue, signed macOS builds are not planned for the time being.
If the project receives sponsorship or other financial support in the future, official signing and notarization may be added.
The packages are self-contained and bring the .NET runtime with them, so nothing has to be installed for that.
libmpv (video) and LibRaw (RAW development) are needed rather than optional. Every package brings LibRaw along. libmpv comes with the Windows downloads and the Flatpak, the other Linux packages ask for it, and on macOS one installed with Homebrew is used. Subtitles are not shown.
libheif opens HEIC, HEIF and AVIF. Every package except the Flatpak brings it along, the Flatpak takes it from its runtime, and macOS tries its own reader first. Without it those files simply stay closed and everything else works.
libjxl opens and saves JPEG XL. Every package except the Flatpak brings it along, the Flatpak takes it from its runtime.
Requires the .NET SDK 10 or newer.
dotnet build FerrumPix.sln
dotnet run --project FerrumPix.vbprojFerrumPix is GPL-3.0-only. Every package carries that licence text and a THIRD-PARTY-NOTICES.txt naming each component and the licence it is used under: Avalonia UI, .NET, ReactiveUI, SkiaSharp, Svg.Skia, Microsoft.Data.Sqlite with SQLitePCLRaw, MetadataExtractor with XmpCore, QRCoder, BitMiracle.LibTiff.NET and ONNX Runtime (MIT, Apache-2.0 or BSD-3-Clause), the Lensfun lens database (CC-BY-SA 3.0), the Nikon, Sony, Pentax and Canon lens identifiers from ExifTool (GPL), Phosphor Icons (MIT), and the bundled LibRaw (LGPL-2.1) with zlib (zlib licence) and libjpeg (IJG licence), libmpv (GPL-2.0-or-later) and libheif with libde265 (both LGPL-3.0) and dav1d (BSD-2-Clause), and libjxl (BSD-3-Clause). For the GPL and LGPL libraries the packages also name the matching source: version, commit and build recipe. The map view, once switched on, shows tiles from OpenStreetMap; the map data is © OpenStreetMap contributors under the Open Database License.
Project website: FerrumPix.app
FerrumPix is in active development. The gallery, viewer, editor, settings and the Immich and Nextcloud integration are already usable. Current work focuses on stability, performance, workflow polish and cleanup.





