KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

rmw

★ 101 Open GitHub ↗

trashcan/recycle bin utility for the command line

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# rmw-0.10.0
## Description

rmw (ReMove to Waste) is a safe-remove and restore utility for the command
line. By default it uses your desktop's trash (the FreeDesktop.org Trash
specification) and needs no setup, though you can add your own waste folders.
It can also purge items after a set number of days.

Web site: <https://theimpossibleastronaut.github.io/rmw-website/>

[![codeql-badge]][codeql-url]
[![c-cpp-badge]][c-cpp-url]

[c-cpp-badge]: https://github.com/theimpossibleastronaut/rmw/actions/workflows/c-cpp.yml/badge.svg
[c-cpp-url]: https://github.com/theimpossibleastronaut/rmw/actions/workflows/c-cpp.yml
[codeql-badge]: https://github.com/theimpossibleastronaut/rmw/workflows/CodeQL/badge.svg
[codeql-url]: https://github.com/theimpossibleastronaut/rmw/actions?query=workflow%3ACodeQL

rmw is for people who sometimes use rm or rmdir at the command line and
would occasionally like an alternative choice. It's not intended or
designed to act as a replacement for rm, as it's more closely related
to how the [FreeDesktop.org trash
system](https://specifications.freedesktop.org/trash-spec/trashspec-latest.html)
functions.

## Features and Usage

See the [manual on the
website](https://theimpossibleastronaut.github.io/rmw-website/rmw_man.html)

## Screenshots

See the [Screenshots](https://theimpossibleastronaut.github.io/rmw-website/screenshots.html)
page on the website.

## Contact / Support

* [Bug Reports](https://github.com/theimpossibleastronaut/rmw/blob/master/CONTRIBUTING.md#bug-reports)
* [General Help, Support, Discussion](https://theimpossibleastronaut.github.io/rmw-website/#support)

## Installation

rmw is available in the [homebrew and
linuxbrew](https://github.com/Homebrew/) repositories; or there may may
be a binary package available for your OS. You can view a list at
[Repology](https://repology.org/project/rmw/versions) to see in which
repositories rmw is included. Since v0.7.09, x86_64 AppImages are
available.

AppImages and maintainer-created amd64 Debian packages are available in
the [releases section][releases-url].

[releases-url]: https://github.com/theimpossibleastronaut/rmw/releases/latest

## Installing from source

### Dependencies

* glib2
* libncursesw (ncurses-devel on some systems, such as CentOS)
* gettext (or use '-Dnls=false' when configuring with meson if you only need English language support)

If you're building from source, you will need the libncursesw(5 or
6)-dev package from your operating system distribution. On some systems
just the ncurses packages is needed, and it's often already installed.

#### Linux only

* linux-headers

`linux/fs.h` from the headers package is required for btrfs/bcachefs
[reflink](https://www.rubdos.be/2017/07/30/about-reflinks.html) support.  `meson setup` will fail if the header is missing. To
bypass the check and exclude support (which is only necessary
if you want `rmw` to be able to move files between subvolumes) add

-Dwith-reflink=false

to the meson setup options.

### Compiling

#### As a normal user:

(This examples places the generated files to a separate folder, but you can
run 'configure' from any directory you like.)

meson setup builddir
    cd builddir
    ninja

Use `meson configure` in the build dir to view or change available
options.

#### Installing without superuser privileges

If you would like to install rmw without superuser privileges, use a prefix
that you have write access to. Example:

meson setup -Dprefix=$HOME/.local builddir

or while in the build dir

meson configure -Dprefix=$HOME/.local

To install:

meson install

In the example above, the rmw binary will be installed to
`$HOME/.local/bin` and documentation to `$HOME/.local/doc`.

### Uninstall

ninja uninstall (uninstalls the program if installed with 'ninja install`)

### Docker

see the [Docker README](https://github.com/theimpossibleastronaut/rmw/tree/master/docker)

rmw

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README