aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Voss <mail@thomasvoss.com> 2023-08-12 15:08:09 +0200
committerThomas Voss <mail@thomasvoss.com> 2023-08-12 15:15:45 +0200
commit92af298435ae573d549a7886eb5367d262782340 (patch)
treeccfc7cd7ef0802be6881794cb2f348ba0ced6dcf
parentc5240658cd621132a55f4f1ad60be2593aee28f8 (diff)
Add a README
-rw-r--r--README.md39
1 files changed, 39 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4aa5493
--- /dev/null
+++ b/README.md
@@ -0,0 +1,39 @@
+# mmv — mapped file moves
+
+The `mmv` utility is a command-line tool to help you easily and safely perform
+complex file moves and -renamings. Unlike basically all file renaming tools I
+have seen online, this utility does lot limit you to using specific built-in
+functions which offer only part of the functionality one might need. This
+utility also tries to be as safe as possible — you would be amazed at how many
+file renaming tools lose your data when you try something as simple as swapping
+two files.
+
+## Installation
+
+Installation is very easy. This is written in Rust, so it’s assumed you have
+`cargo` installed on your system.
+
+```
+$ make
+$ sudo make install
+```
+
+## Examples and Documentation
+
+To avoid repeating myself everywhere, if you would like to see usage examples
+and documentation I highly suggest reading the [included manual page][1] or
+reading the extended documentation [on my website][2].
+
+## Contributions
+
+Contributions, feedback, and suggestions are always welcome! You are free to
+open GitHub issues, email me, or do whatever else you want. I do ask however
+that contributions be made either on [sourcehut][3] or via [`git send-email`][4]
+to [~mango/public-inbox@lists.sr.ht][5]. The git repositories on GitHub and my
+own personal site exist purely as read-only mirrors.
+
+[1]: mmv.1
+[2]: https://thomasvoss.com/prj/mmv
+[3]: https://sr.ht/~mango/mmv
+[4]: https://git-send-email.io/
+[5]: mailto:~mango/public-inbox@lists.sr.ht