schrottkatze/karton
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases 2 Packages Wiki Activity
karton/README.MD
Dániel Szabó dd9648cd2e
Update README.MD
2022-04-23 16:57:45 +01:00

2.2 KiB
Raw Blame History

MicroBin

Screenshot

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)

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. 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.

[Unit]
Description=MicroBin
After=network.target
[Service]
Type=simple
Restart=always
ExecStart=/home/pi/microbin/target/release/microbin
[Install]
WantedBy=multi-user.target

Then start the service with systemctl start microbin and enable it on boot with systemctl enable microbin.

Create Pasta with cURL

Simple text Pasta: curl -d "expiration=10min&content=This is a test pasta" -X POST https://microbin.myserver.com/create

File contents: curl -d "expiration=10min&content=$( < mypastafile.txt )" -X POST https://microbin.myserver.com/create

Available expiration options:

  • 1min
  • 10min
  • 1hour
  • 24hour
  • 1week
  • never

Use cURL to read the pasta: curl https://microbin.myserver.com/rawpasta/fish-pony-crow

or to download the pasta: curl https://microbin.myserver.com/rawpasta/fish-pony-crow > output.txt

Needed improvements

  • Persisting pastas on disk (currently they are lost on restart)
  • Removing pasta after N reads
  • File uploads
  • URL shortening (added on 23 April 2022)
  • CLI tool
  • Configuration with command line arguments (ports, enable-disable pasta list, footer, etc)