https://github.com/celsiusnarhwal/rm-trash

🗑 Safe(r) deletion of files from the macOS command line
https://github.com/celsiusnarhwal/rm-trash

cli file-management rm rmdir trash

Last synced: about 1 month ago
JSON representation

🗑 Safe(r) deletion of files from the macOS command line

• Host: GitHub
• URL: https://github.com/celsiusnarhwal/rm-trash
• Owner: celsiusnarhwal
• License: mit
• Created: 2022-12-24T02:39:11.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2022-12-29T03:05:05.000Z (almost 2 years ago)
• Last Synced: 2024-08-30T23:56:27.644Z (4 months ago)
• Topics: cli, file-management, rm, rmdir, trash
• Language: Python
• Homepage:
• Size: 29.3 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# rm-trash

[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/celsiusnarhwal/rm-trash?logo=github&color=orange&logoColor=white&style=for-the-badge)](https://github.com/celsiusnarhwal/rm-trash/releases)

rm-trash is a macOS command-line utility that moves files and directories to the Trash.

Unlike [similar](https://github.com/ali-rantakari/trash) [tools](https://github.com/sindresorhus/macos-trash),

rm-trash intends to be a complete alternative to `rm` and `rmdir`, to the extent that you could use aliases

to have rm-trash replace them both.

rm-trash works by communicating with Finder

through [AppleScript](https://developer.apple.com/library/archive/documentation/AppleScript/Conceptual/AppleScriptLangGuide/introduction/ASLR_intro.html),

so it's no different from moving files to the Trash

from within Finder itself.

## Installation

Install rm-trash with [Homebrew](https://brew.sh) via

the [Houkago Tea Tap](https://github.com/celsiusnarhwal/homebrew-htt).

```bash

brew tap celsiusnarhwal/htt

brew install rm-trash

```

## Usage

Invoke rm-trash with the `trash` command, which will become available after installation.

```bash

trash --help

```

will tell you everything you need to know.

## Replacing `rm` and `rmdir`

If you wish, you can replace `rm` and `rmdir` with aliases to `trash`.

```bash

alias rm="trash trash"

alias rmdir="trash dir"

```

`trash` supports all options of both commands. Run `trash --help` for details.

## Limitations

rm-trash refuses to as root when [System Integrity Protection](https://support.apple.com/en-us/HT204899) (SIP) is

disabled.

You can still run rm-trash as a non-root user when SIP is disabled, or as any user when SIP is enabled. This limitation

is intended to prevent you from accidentally trashing files and directories that are typically protected by SIP.

If you must remove files as root while SIP is disabled, you can always fall back to `rm`.

## License

rm-trash is licensed under the [MIT License](LICENSE.md).