Instructions to use abr00kx/nemo-smooth with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- NeMo
How to use abr00kx/nemo-smooth with NeMo:
# tag did not correspond to a valid NeMo domain.
- Notebooks
- Google Colab
- Kaggle
nemo-smooth
Nemo, the Cinnamon file manager, made smooth: animated wheel scrolling, roughly twice the frame rate, thumbnails several times faster, and an optional Wayland-only build.
This is a modified version of Nemo (upstream master after 6.8.4, commit 33892205). Every change was measured first and checked afterwards: each optimisation was profiled with perf, timed with a frame benchmark, and verified with screenshots that match upstream pixel for pixel.
What changed
| Upstream | nemo-smooth | |
|---|---|---|
| Icon view, steady scroll: main-thread work per frame (median) | 17 ms | 6.3β6.8 ms |
| Icon view, steady scroll: frame rate | 38β40 fps | 53β59 fps |
| Icon view, mouse wheel: frame rate | 19β25 fps | 52β56 fps |
| Mouse wheel: how the view moves per notch | one 84 px jump | glides, ~28β36 px per frame |
| List view, 10,000 files: work per frame | 38 ms | 21 ms |
| List view, 10,000 files: frame rate | 21 fps | 33 fps |
| 150 12-megapixel JPEGs, cold thumbnail cache | 31.5 s | 3.6 s |
| Thumbnails shown during a fast scroll | about a third | most |
Measured on a 2014 laptop (Haswell i7-4712MQ, HD 4600) at 2x scale, in a headless wlroots compositor with the GLES2 renderer.
Animated mouse-wheel scrolling. Each notch moves the same distance as before but glides over 160 ms (ease-out, timed by the frame clock). Spinning the wheel keeps it moving, and reversing turns it round without a jump. Touchpads and touchscreens keep GTK's own pixel-precise scrolling. Setting:
org.nemo.preferences smooth-scrolling.No hidden full-window paints. GTK3 repaints a scrolled view from the window down on every frame. The window's and the tab container's backgrounds were painted under the view only to be covered, and the view then repainted over GDK's frame clear. Now the clear paints the view's colour and nothing paints underneath it (
nemo_view_paints_over,nemo_view_draw_around).Label text and scaled thumbnails are cached. Icons that scrolled into view rebuilt and re-wrapped their labels on every frame, and thumbnails were rescaled on every redraw.
List view keeps GtkTreeView's pixel cache.
gdk_window_scroll()invalidated the whole row area on every scroll step, so every visible row was redrawn each frame. A filter in front of the tree view's invalidate handler drops exactly that invalidation (eel_gtk_tree_view_keep_pixel_cache_on_scroll).Fast JPEG thumbnails. JPEG photos are decoded directly at thumbnail size (libjpeg DCT scaling to 1/2, 1/4 or 1/8), rotated by their EXIF orientation, and saved to the standard thumbnail cache. Before, each photo was decoded at full size in a sandboxed external process. Other formats, remote files and unusual JPEGs still use the external thumbnailer. Setting:
org.nemo.preferences fast-jpeg-thumbnails.Thumbnails appear while you scroll. The visible-icons update was debounced, so it never ran during a continuous scroll. It is now throttled to at most every 50 ms and only touches icons that just came into view. Cached thumbnails are also read and decoded on a worker thread instead of the main loop.
Wayland-only build.
meson setup build -Dx11=falsebuilds without libX11. Nemo then never falls back to XWayland, whateverGDK_BACKENDsays. Media keys now use GDK's own key names, and--geometryparsing no longer needs Xlib.Thumbnails are never skipped. Nemo's visible-icons update restarted its timer on every request, so a stream of requests (files loading, scrolling) could keep postponing it, and icons scrolled past in the meantime never got thumbnails. Now an update already due sooner is never pushed back. Paging through 3,000 JPEGs with a cold cache, every one gets a thumbnail (upstream: 2,810 of 3,000).
Fewer GTK3-only libraries, as groundwork for GTK4:
- cinnamon-desktop β gnome-desktop-4, which has the same thumbnail factory but needs no GTK. Thumbnailing speed is unchanged.
- Favorites are now Nemo's own (
nemo-favorites.c), written from scratch in place of libxapp's. It uses the same stored data (org.x.apps.favorites), so Cinnamon and the X-Apps stay in sync, and provides thefavorites:///folder. A test covers it (test/test-nemo-favorites.c). -Dxapp=falsebuilds without libxapp. That drops the file-operations tray icon (closing the progress window then minimises it instead) and uses a file chooser for custom icons.
patches/ has each change as a patch against upstream (18 so far), with a full explanation and the measurements in its commit message.
Trade-offs to know
fast-jpeg-thumbnailsgives up the sandbox for JPEGs. It decodes JPEGs inside Nemo's own process with libjpeg-turbo, as gdk-pixbuf used to, instead of in glycin's sandbox. To decode everything sandboxed again:gsettings set org.nemo.preferences fast-jpeg-thumbnails false.- Smooth scrolling can be turned off. Use
gsettings set org.nemo.preferences smooth-scrolling false, or turn off GTK animations. - Same pixels, apart from timing. Rendering is designed to match upstream exactly. In checks of icon view, list view and split view, screenshots differed from upstream only in the overlay scrollbar, where its fade-out timing happened to differ.
Building
Same as upstream Nemo (meson, GTK 3), except: gnome-desktop-4 instead of cinnamon-desktop, plus libjpeg.
meson setup build --buildtype=debugoptimized -Dgtk_layer_shell=true
# Wayland only, without libxapp: -Dx11=false -Dxapp=false
ninja -C build
sudo meson install -C build
With ccache, a clean build takes about 45 s on 8 threads.
Benchmark tools
tools/scroll-bench/ measures scrolling in a real Nemo:
libnemo-scroll-bench.sois a GTK module loaded into an unmodified Nemo.bench.pyruns Nemo insidecage(headless, 2x scale, GLES2, private D-Bus session and throwaway settings).
make -C tools/scroll-bench
tools/scroll-bench/bench.py gen # test folders (10k files, 3k images, 150 photos)
tools/scroll-bench/bench.py run --folder images --view icon # frame timing
tools/scroll-bench/bench.py compare --base /path/to/upstream/build/src/nemo
tools/scroll-bench/bench.py run --perf && tools/scroll-bench/perf-breakdown.sh tools/scroll-bench/perf-images-icon-warm.data
tools/scroll-bench/bench.py shot --values 0,9000 # screenshot both builds, diff pixels
tools/scroll-bench/bench.py thumbs --folder photos # cold-cache thumbnailing
GTK4 port (in progress)
Phase 0: measuring first. tools/gtk4-proto/ is a small GTK4 folder view built to measure GTK4 scrolling before porting anything. The same benchmark drives it (bench.py run --nemo tools/gtk4-proto/nemo4-proto). Its icon view is NemoGrid, a virtualized grid that draws every visible item itself, with no widget per cell, and caches each item's text layout and thumbnail. GTK's stock GtkGridView stutters further down large folders: it binds about 55 cells in one frame every few frames. On the same machine, at 2x with GTK's GL renderer:
| GTK3 nemo-smooth | GTK4 prototype | |
|---|---|---|
List view (GtkColumnView), 10,000 files |
33 fps, 21 ms per frame | 62 fps, 3.1β3.6 ms |
| Icon view (NemoGrid), 10,000 files | 53β59 fps, 6.3 ms | 62 fps, median 5.2 ms |
| Icon view (NemoGrid), 3,000 photos | 53β59 fps | 62 fps, median 1.7β1.9 ms |
Icon view (stock GtkGridView), deep in 10,000 files |
42 fps, p95 about 54 ms |
Step 1, done: the core builds against GTK4. With -Dgtk4=true, Nemo's core (eel, libnemo-extension and libnemo-private's model layer) is also built against GTK4, from the same sources as the GTK3 build. It covers files and folders, icons and thumbnails, favorites, bookmarks, undo, search, and the file operations with their dialogs. eel/eel-gtk-compat.h covers the handful of calls GTK4 renamed or dropped. test/test-nemo-core-gtk4.c loads a folder through it. The GTK3 build is unchanged: the same benchmark numbers, and pixel-identical dialogs. tools/gtk4-port/gtk4-check.py measures progress: 82 of 114 core files compile against GTK4, and the rest are GTK3's views, menus and drag and drop, which the port replaces.
Next: nemo4, installed next to the GTK3 Nemo. It gets the NemoGrid icon view (large and compact), the list view, the places sidebar with favorites, the path bar and navigation. Then menus and actions, drag and drop, and a GTK4 extension API (extensions-4, since GTK3 and GTK4 extensions can't share a process). Desktop icons are not ported.
License
GPL-2.0-or-later, as upstream Nemo (COPYING). The extension library is LGPL (COPYING.LIB, COPYING.EXTENSIONS). The changes listed above were made in November 2026; see patches/ for exactly what changed. All credit for Nemo itself goes to the Linux Mint team and Nemo's contributors.
The original upstream README follows.
Nemo
Nemo is a free and open-source software and official file manager of the Cinnamon desktop environment. It is a fork of GNOME Files (formerly named Nautilus).
Nemo also manages the Cinnamon desktop. Since Cinnamon 6.0 (Mint 21.3), users can enhance their own Nemo with Spices named Actions.
History
Nemo started as a fork of the GNOME file manager Nautilus v3.4. Version 1.0.0 was released in July 2012 along with version 1.6 of Cinnamon, reaching version 1.1.2 in November 2012.
Developer Gwendal Le Bihan named the project "nemo" after Jules Verne's famous character Captain Nemo, who is the captain of the Nautilus.
Features
Nemo v1.0.0 had the following features as described by the developers:
- Ability to SSH into remote servers
- Native support for FTP (File Transfer Protocol) and MTP (Media Transfer Protocol)
- All the features Nautilus 3.4 had and which are missing in Nautilus 3.6 (all desktop icons, compact view, etc.)
- Open in terminal (integral part of Nemo)
- Open as root (integral part of Nemo)
- Uses GVfs and GIO
- File operations progress information (when copying or moving files, one can see the percentage and information about the operation on the window title and so also in the window list)
- Proper GTK bookmarks management
- Full navigation options (back, forward, up, refresh)
- Ability to toggle between the path entry and the path breadcrumb widgets
- Many more configuration options
- Downloads last month
- -