schrottkatze/karton
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases 2 Packages Wiki Activity

Update README.MD

Browse source
This commit is contained in:
Dániel Szabó 2022-04-23 16:57:45 +01:00 committed by GitHub
parent 1c7b4f4b3a
commit dd9648cd2e
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 13 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
README.MD
View file

@ -2,10 +2,21 @@
![Screenshot](git/index.png) ![Screenshot](git/index.png)
MicroBin is a super tiny and simple self hosted pastebin app written in Rust. The executable is around 6MB and it uses 2MB memory (plus your pastas). MicroBin is a super tiny and simple self hosted pastebin app written in Rust. The executable is around 6MB and it uses 2MB memory (plus your pastas, because they are all stored in the memory at the moment).
### Features
- Is very small
- Automatic dark mode (follows system preferences)
- Animal names instead of random numbers for pasta identifiers (64 animals)
- Automatically expiring pastas
- Never expiring pastas
- Listing and manually removing pastas (/pastalist)
- Raw pasta content (/raw/[animals])
- URL shortening and redirection
- Very little CSS and absolutely no JS (see [water.css](https://github.com/kognise/water.css))
### Installation ### Installation
Simply clone the repository, build it with `cargo build --release` and run the `microbin` executable in the created `target/release/` directory. It will start on port 8080. Simply clone the repository, build it with `cargo build --release` and run the `microbin` executable in the created `target/release/` directory. It will start on port 8080. You can change the port with `-p` or `--port` CL arguments.
To install it as a service on your Linux machine, create a file called `/etc/systemd/system/microbin.service`, paste this into it with the value of `ExecStart` replaced with the actual path to microbin on your machine. To install it as a service on your Linux machine, create a file called `/etc/systemd/system/microbin.service`, paste this into it with the value of `ExecStart` replaced with the actual path to microbin on your machine.
@ -41,13 +52,6 @@ Use cURL to read the pasta: `curl https://microbin.myserver.com/rawpasta/fish-po
or to download the pasta: `curl https://microbin.myserver.com/rawpasta/fish-pony-crow > output.txt` or to download the pasta: `curl https://microbin.myserver.com/rawpasta/fish-pony-crow > output.txt`
### Features
- Very little CSS and no JS, super lightweight and simple (see [water.css](https://github.com/kognise/water.css))
- Animal names instead of random numbers for pasta identifiers
- Automatically expiring pastas
- Never expiring pastas
- Listing and manually removing pastas
- URL shortening and redirection
### Needed improvements ### Needed improvements
- Persisting pastas on disk (currently they are lost on restart) - Persisting pastas on disk (currently they are lost on restart)
@ -56,4 +60,3 @@ or to download the pasta: `curl https://microbin.myserver.com/rawpasta/fish-pony
- ~~URL shortening~~ (added on 23 April 2022) - ~~URL shortening~~ (added on 23 April 2022)
- CLI tool - CLI tool
- Configuration with command line arguments (ports, enable-disable pasta list, footer, etc) - Configuration with command line arguments (ports, enable-disable pasta list, footer, etc)