Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/abaldwin88/roamer
The Plain Text File Manager
https://github.com/abaldwin88/roamer
Last synced: about 2 months ago
JSON representation
The Plain Text File Manager
- Host: GitHub
- URL: https://github.com/abaldwin88/roamer
- Owner: abaldwin88
- License: mit
- Created: 2017-07-03T12:30:47.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-11-28T12:43:21.000Z (almost 5 years ago)
- Last Synced: 2024-07-16T23:37:30.919Z (2 months ago)
- Language: Python
- Homepage:
- Size: 99.6 KB
- Stars: 606
- Watchers: 12
- Forks: 15
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Roamer [](https://travis-ci.org/abaldwin88/roamer)
### The Plain Text File Manager
[](https://asciinema.org/a/132587)
Roamer turns your favorite text editor into a lightweight file manager. Copy, Cut & Paste files en masse without leaving your terminal window.
## Install
#### Requirements
* Python version: 2.7+, 3.4+
* OS: Linux, MacOS, Windows WSL (Windows Subsystem for Linux)
#### Command
```shell
sudo pip install roamer
```
For a high security install see [here](doc/faq.md).
## Usage
### Start Roamer
```shell
$ roamer
```
This will open the current working directory in your default $EDITOR. (See options section to override editor)
### Example Output
```shell
" pwd: /Users/abaldwin/Desktop/stuff
my_directory/ | b0556598b8f8
my_file_1.txt | ce9b0a287985
my_file_2.txt | fc3da7f790a6
my_file_3.txt | fc3da7f790a6
```
### Explanation
* Each line represents a single entry (file or directory)
* On the left side of the pipe character is the entry's name
* On the right side is the entry's hash. You can think of the hash as a link to that entry's contents.
* A line starting with double quote (") is a comment and will be ignored.
--> Make changes as desired. When finished save and quit to commit the changes. e.g. vim `:wq`
### Common Operations
#### Delete a file
* Delete the line
#### Copy a file
* Copy the entire line
* Paste it onto a new line
#### Rename a file
* Type over the existing file's name
* Do not modify the hash on the right side
#### Copy over a file
* Copy the hash from the first file
* Replace the second file's hash
#### Make a new empty file
* Add a new line
* Type the new file's name
#### Move files between directories
* Open up another terminal tab and run second roamer session
* Copy / Paste lines between both sessions of roamer
## Options
#### Editor
Roamer uses your default $EDITOR environment variable.
To override a specific editor for roamer add this to your shell's config. (~/.bashrc ~/.zshrc etc)
```shell
export ROAMER_EDITOR=emacs
```
If no editor is set then vi will be used.
[Works with any editor?](doc/faq.md#any-text-editor)
#### Data Directory
Roamer needs a directory for storing data between sessions. By default this will be saved in `.roamer-data` in your home directory.
To override:
```shell
export ROAMER_DATA_PATH=~/meh/
```
## Editor Plugins
This roamer library is editor agnostic and focused on processing plain text. To enhance your experience with roamer consider installing roamer editor plug-ins:
* https://github.com/abaldwin88/roamer.vim