• Stars
    star
    486
  • Rank 90,527 (Top 2 %)
  • Language
    Rust
  • License
    GNU General Publi...
  • Created about 2 years ago
  • Updated 5 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Drag and Drop utilty written in Rust and GTK4

What is ripdrag?

Crates.io GitHub top language Crates.io

ripdrag is an application that lets you drag and drop files from and to the terminal.

It's designed to be feature to feature* compatible with dragon, while being written in modern Rust and GTK4.

Example.mp4

*some features like --on-top can't be ported over because of limitations in gtk4

Use cases

Many applications expect files to be dragged into them. Normally you would have to put your beloved terminal aside and open a file manager to that, but now you can just type ripdrag FILENAME and be done.

Used in combination with a fuzzy finder like fzf - e.g. ripdrag $(fzf) - can make for an amazingly quick and painless terminal experience.

Installation

Install the required dependencies

Ubuntu 22.04 or later

sudo apt install cargo libgtk-4-dev build-essential

Fedora\CentOS\RHEL

sudo dnf install cargo gdk-pixbuf2-devel pango-devel graphene-devel cargo-devel cairo-gobject-devel cairo-devel python2-cairo-devel gtk4-devel

Arch Linux

sudo pacman -Sy --needed rust gtk4 base-devel

MacOS

You need to have homebrew installed.

brew install rustup gtk4
rustup-init

NetBSD

A pre-compiled binary is available from the official repositories. To install it simply run,

pkgin install ripdrag

Install the binary

(Do not use sudo, if you don't want it to be installed on root)

cargo install ripdrag

Add cargo to path

(Not added by default)

PATH=$PATH:~/.cargo/bin

Usage

USAGE:
    ripdrag [OPTIONS] [PATHS]...

ARGS:
    <PATHS>...    Paths to the files you want to drag

OPTIONS:
    -v, --verbose                  Be verbose
    -t, --target                   Act as a target instead of source
    -k, --keep                     With --target, keep files to drag out
    -p, --print-path               With --target, keep files to drag out
    -r, --resizable                Make the window resizable
    -x, --and-exit                 Exit after first successful drag or drop
    -i, --icons-only               Only display icons, no labels
    -d, --disable-thumbnails       Don't load thumbnails from images
    -s, --icon-size <SIZE>         Size of icons and thumbnails [default: 32]
    -W, --content-width <WIDTH>    Min width of the main window [default: 360]
    -H, --content-height <HEIGHT>  Default height of the main window [default: 360]
    -I, --from-stdin               Accept paths from stdin
    -a, --all                      Drag all the items together
    -A, --all-compact              Show only the number of items and drag them together
    -h, --help                     Print help information
    -V, --version                  Print version information

TODO

There are still lots of thing to be done! Mainly:

  • clean up code
  • pacman, deb, rpm, windows and macos build scripts
  • automated builds

Feel free to contribute ;)