https://github.com/HKey/dired-atool

Pack/unpack files with atool on dired.
https://github.com/HKey/dired-atool

Last synced: 2 months ago
JSON representation

Pack/unpack files with atool on dired.

• Host: GitHub
• URL: https://github.com/HKey/dired-atool
• Owner: HKey
• Created: 2016-01-19T10:20:01.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2021-07-19T04:07:10.000Z (over 3 years ago)
• Last Synced: 2024-08-02T01:26:20.343Z (6 months ago)
• Language: Emacs Lisp
• Homepage:
• Size: 31.3 KB
• Stars: 10
• Watchers: 2
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: ChangeLog.md

Awesome Lists containing this project

README

        
# dired-atool

[![Build Status](https://travis-ci.org/HKey/dired-atool.svg?branch=master)](https://travis-ci.org/HKey/dired-atool)

[![MELPA](https://melpa.org/packages/dired-atool-badge.svg)](https://melpa.org/#/dired-atool)

[![MELPA Stable](https://stable.melpa.org/packages/dired-atool-badge.svg)](https://stable.melpa.org/#/dired-atool)

Dired-atool is an utility to pack/unpack files with [atool](http://www.nongnu.org/atool/) on dired.

## Requirements

- Emacs 24 or later

## Installation

You can install dired-atool from [MELPA](https://melpa.org/#/) or

[MELPA Stable](https://stable.melpa.org/#/) by following steps:

1. Setup the Emacs built-in package manager to use MELPA or MELPA Stable.  

   MELPA's documentation is [here](https://github.com/melpa/melpa#usage).

2. Install dired-atool.  

   `M-x package-install dired-atool`

## Setup key bindings

Call `dired-atool-setup` in your init.el like below:

```emacs-lisp

(dired-atool-setup)

```

or `M-x dired-atool-setup`.

`dired-atool-setup` sets key bindings of `dired-mode-map` below:

| key | command                 |

|-----|-------------------------|

| z   | `dired-atool-do-unpack` |

| Z   | `dired-atool-do-pack`   |

You can also set key bindings manually like below:

```emacs-lisp

(require 'dired)

(define-key dired-mode-map "z" #'dired-atool-do-unpack)

(define-key dired-mode-map "Z" #'dired-atool-do-pack)

```

## Versioning

The versioning of dired-atool follows [Semantic Versioning 2.0.0](http://semver.org/spec/v2.0.0.html).

## Commands

### `dired-atool-do-unpack`

This unpacks file(s) selected/marked on dired.

### `dired-atool-do-unpack-to-current-dir`

This is an unpacking command like `dired-atool-do-unpack`.

But this always unpacks file(s) into the current directory.

### `dired-atool-do-unpack-with-subdirectory`

This is an unpacking command like `dired-atool-do-unpack`.

But this makes subdirectories in the current directory and unpacks

files into them.

### `dired-atool-do-pack`

This packs file(s) selected/marked on dired.