Git Product home page Git Product logo

snapshot-explorer's Introduction

Snapshot Explorer

Snapshot Explorer is a work-in-progress GTK-based application for browsing ZFS snapshots using the system file manager (e.g. Nautilus on GNOME).

Screenshot of the application

It also includes a standalone Nautilus extension to enable easy restoration of earlier versions of a file from a ZFS snapshot.

Screenshot of the Nautilus extension

Together these give an experience similar to Time Machine on macOS, the "Previous Versions" feature on Windows, or the TimeSlider Nautilus patches from OpenSolaris and its descendants -- all of which inspired this tool.

Snapshot Explorer is not:

  • A ZFS snapshot scheduling tool. There are many available programs for this already. Snapshot Explorer should be able to work with snapshots created by any of them, or manually via the ZFS utilities.

  • A general-purpose ZFS administration GUI. It is intended purely for exploring snapshots of locally-mounted filesystems.

Planned features:

  • BTRFS support.

  • Browsing of additional snapshots stored on an external/remote pool.

Building and Installation

You'll need the following dependencies, using Debian-style package names:

  • libglib2.0-dev
  • libgtk-3-dev
  • libhandy-1-dev (for the application)
  • libnautilus-extension-dev (for the Nautilus extension)
  • meson
  • valac

You will need ZFS filesystem(s) for this tool to be useful, but it has no dependencies on ZFS during installation.

On Linux, you will also need the userspace ZFS utilities (from zfsutils-linux) to actually see available snapshots in the UI.

Run meson build to configure the build environment, then run ninja in the new build directory to build:

meson build --prefix=/usr/local
cd build
ninja

You can pass -Denable-nautilus-extension=false to meson to disable building the Nautilus extension.

To install the application and possibly the extension, use ninja install, then execute snapshot-explorer:

sudo ninja install
snapshot-explorer

snapshot-explorer's People

Contributors

atheriel avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

Forkers

2b venomtek niziak

snapshot-explorer's Issues

Nautilus extension does not build against GNOME 43 and later

I am running debian trixie / testing amd64. I have installed all the deps listed as needed to build snapshot -explorer including libnautilus-extension-dev but I currently only get as far as this when trying to build it:

$ meson build --prefix=/usr/local
The Meson build system
Version: 1.2.3
Source dir: /home/dan/src/snapshot-explorer
Build dir: /home/dan/src/snapshot-explorer/build
Build type: native build
Project name: snapshot-explorer
Project version: 0.1.0
C compiler for the host machine: cc (gcc 13.2.0 "cc (Debian 13.2.0-13) 13.2.0")
C linker for the host machine: cc ld.bfd 2.42
Vala compiler for the host machine: valac (valac 0.56.14)
Host machine cpu family: x86_64
Host machine cpu: x86_64
Program msgfmt found: YES (/usr/bin/msgfmt)
Program desktop-file-validate found: YES (/usr/bin/desktop-file-validate)
Program appstream-util found: NO
Program glib-compile-schemas found: YES (/usr/bin/glib-compile-schemas)
Found pkg-config: /usr/bin/pkg-config (1.8.1)
Run-time dependency gio-2.0 found: YES 2.78.4
Run-time dependency gtk+-3.0 found: YES 3.24.41
Run-time dependency libhandy-1 found: YES 1.8.3
Found pkg-config: /usr/bin/pkg-config (1.8.1)
Dependency gio-2.0 found: YES 2.78.4 (cached)
Program /usr/bin/glib-compile-resources found: YES (/usr/bin/glib-compile-resources)
Program msginit found: YES (/usr/bin/msginit)
Program msgmerge found: YES (/usr/bin/msgmerge)
Program xgettext found: YES (/usr/bin/xgettext)
Found CMake: /usr/bin/cmake (3.28.3)
WARNING: CMake Toolchain: Failed to determine CMake compilers state
Run-time dependency libnautilus-extension found: NO (tried pkgconfig and cmake)

nautilus/meson.build:16:16: ERROR: Dependency "libnautilus-extension" not found, tried pkgconfig and cmake

A full log can be found at /home/dan/src/snapshot-explorer/build/meson-logs/meson-log.txt
WARNING: Running the setup command as `meson [options]` instead of `meson setup [options]` is ambiguous and deprecated.

Is snapshot explorer known to work with the current (or even recent) GNOME releases?

Can't build under Ubuntu 20.04

Is Ubuntu 20.04 too old to build and run snapshot-explorer?

I installed all of the deps listed in your readme but when running:

meson build --prefix=/usr/local

The build only gets as far as:

data/meson.build:1:0: ERROR: Tried to assign an invalid value to variable.

This is when using meson 0.53.2.

Fails to build on Ubuntu 23.04

$ meson build 
...
Preliminary CMake check failed. Aborting.
Run-time dependency libnautilus-extension4 found: NO (tried pkgconfig and cmake)

nautilus/meson.build:16:0: ERROR: Dependency "libnautilus-extension4" not found, tried pkgconfig and cmake
$ cat  build/meson-logs/meson-log.txt
...
Called `/usr/bin/pkg-config --modversion libnautilus-extension` -> 1
stderr:
Package libnautilus-extension was not found in the pkg-config search path.
Perhaps you should add the directory containing `libnautilus-extension.pc'
to the PKG_CONFIG_PATH environment variable
Package 'libnautilus-extension', required by 'virtual:world', not found
$ dpkg -l | grep libnautilus                    


ii  libnautilus-extension-dev:amd64               1:44.2.1-0ubuntu1                       amd64        libraries for nautilus components - development version
ii  libnautilus-extension4:amd64                  1:44.2.1-0ubuntu1                       amd64        libraries for nautilus components - runtime version

$ dpkg -L libnautilus-extension-dev | grep 'libnautilus-extension.*\.pc'
/usr/lib/x86_64-linux-gnu/pkgconfig/libnautilus-extension-4.pc

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.