explaingit

romgrk/mariner

Analysis updated 2026-05-18

43TypeScriptAudience · generalComplexity · 2/5Setup · easy

TLDR

Mariner is a GNOME file manager that looks like GNOME Files but adds split view, quick preview, full-text search, and a command palette.

Mindmap

mindmap
  root((Mariner))
    What it does
      GNOME file manager
      Split view browsing
      Quick preview
      Full text search
    Tech stack
      TypeScript
      GTK4
      libadwaita
    Use cases
      Dual pane file management
      Disk usage analysis
      Tagging files
    Audience
      GNOME desktop users
      Linux users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Browse and manage files on GNOME Linux with familiar Nautilus-style controls plus extra features.

USE CASE 2

Copy or move files between two folders shown side by side in a split view.

USE CASE 3

Search inside files across a whole folder tree without building a search index.

USE CASE 4

Preview images, video, and text files instantly by pressing space.

What is it built with?

TypeScriptGTK4libadwaitaripgrep

How does it compare?

romgrk/marinerfberrez/quietdash.comflaviojmendes/dinamos
Stars434343
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardmoderate
Complexity2/54/53/5
Audiencegeneralvibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Currently in beta, install as a GNOME desktop application.

The explanation does not state a license, so terms of use are unclear.

In plain English

Mariner is a file manager application for the GNOME Linux desktop, built as an alternative to the default file manager called GNOME Files, also known as Nautilus. It uses the same visual building blocks as GNOME Files, so it looks and behaves the same way people already expect, with the same sidebar, tabs, and keyboard shortcuts, but it adds a long list of features that users of GNOME Files have asked for over the years. One of the main additions is type ahead navigation: as soon as you start typing, Mariner jumps to the matching file or folder, and the matching is forgiving of typos, so a slightly misspelled name still finds the right result. Another major feature is a dual pane split view, letting you see two folders side by side in one window so you can drag, copy, or move files between them without opening a second window. Pressing the space bar on a file opens an instant preview for images, video, audio, text, and code, and a command palette, opened with a keyboard shortcut, lets you jump to any folder you have visited before or run a command, similar to how a code editor's command palette works. Mariner also includes a way to run shell commands directly from its location bar, with the output shown in a panel at the bottom of the window, and a full text search feature that can search inside files using the ripgrep search tool, without needing to build a search index first. A built in disk usage tool shows what is taking up space on a drive as a colored sunburst chart you can click through. Files can also be given colored tags from the right click menu, and those tags are stored using a standard file attribute so they stay attached to files even when copied and remain compatible with a similar tagging feature in the KDE desktop's file manager, Dolphin. Other differences from GNOME Files include custom right click actions that users can define in a small configuration file, an operations queue that shows each file copy or move separately with its own progress, batch renaming with a live preview, and built in support for extracting and creating zip, tar, and other archive formats. The project is currently in beta and is written mainly in TypeScript. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
How do I install Mariner as a file manager alternative on my GNOME desktop?
Prompt 2
Explain how Mariner's type-ahead navigation and split view work.
Prompt 3
Show me how to set up a custom right-click action in Mariner.
Prompt 4
What features does Mariner add on top of GNOME Files?

Frequently asked questions

What is mariner?

Mariner is a GNOME file manager that looks like GNOME Files but adds split view, quick preview, full-text search, and a command palette.

What language is mariner written in?

Mainly TypeScript. The stack also includes TypeScript, GTK4, libadwaita.

What license does mariner use?

The explanation does not state a license, so terms of use are unclear.

How hard is mariner to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mariner for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.