1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
# Btrfs Assistant
## Overview
Btrfs Assistant is a GUI management tool to make managing a Btrfs filesystem easier. The primary features it offers are:
* An easy to read overview of Btrfs metadata
* A simple view of subvolumes with or without Snapper/Timeshift snapshots
* Run and monitor scrub and balance operations
* A pushbutton method for removing subvolumes
* A management front-end for Snapper with enhanced restore functionality
* View, create and delete snapshots
* Restore snapshots in a variety of situations
* When the filesystem is mounted in a different distro
* When booted off a snapshot
* From a live ISO
* View, create, edit, remove Snapper configurations
* Browse snapshots and restore individual files
* Browse diffs of a single file across snapshot versions
* Manage Snapper systemd units
* A front-end for Btrfs Maintenance
* Manage systemd units
* Easily manage configuration for defrag, balance and scrub settings
## Installing
#### Arch
Btrfs Assistant can be installed from the AUR as `btrfs-assistant`
#### Debian
There are unofficial Debian packages [here](https://software.opensuse.org/download/package?package=btrfs-assistant&project=home:iDesmI:more) coutesy of @idesmi or you can follow the instructions for Ubuntu to build it yourself.
#### Ubuntu
1. Install the prerequisites: `sudo apt install git cmake fonts-noto qt6-base-dev qt6-base-dev-tools g++ libbtrfs-dev libbtrfsutil-dev pkexec qt6-svg-dev qt6-tools-dev`
1. Download the tar.gz from the latest version [here](https://gitlab.com/btrfs-assistant/btrfs-assistant/-/tags)
1. Untar the archive and cd into the directory
1. `cmake -B build -S . -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE='Release'`
1. `make -C build`
1. `sudo make -C build install`
1. Optionally install Snapper - `sudo apt install snapper`
#### Fedora
Btrfs Assistant is available in the Fedora repos as `btrfs-assistant`
## Contributing
Contributions are welcome!
Please see [CONTRIBUTING.md](docs/CONTRIBUTING.md) for more details.
### Development Requirements
* Qt6 / Qt Design UI
* C++17
* Cmake >= 3.5
* Root user privileges
* Btrfs filesystem
|
