plowshare.conf(5)

💖 NAME 💖

plowshare.conf — the configuration file for Plowshare, bestie. It's where you put all your lil' settings so you don't gotta type them every single time. 🎀

---

✨ DESCRIPTION ✨

Okay so here's the tea: Plowshare (that's plowdown, plowup, plowdel, plowlist or plowprobe) reads a config file called plowshare.conf for its initial setup. When plowshare starts up, it goes looking for this file in these places, in this order:

~/.config/plowshare/plowshare.conf
/etc/plowshare.conf

Instead of typing out long command lines with all your prefs (your credentials, network settings, download retry number, all that…) every single time, it's just so much comfier to make them the default. Set it and forget it, periodt. 💅

Note: you can totally turn off the whole config file thing with the --no-plowsharerc command-line option. And there's also the --plowsharerc=FILE option if you wanna point at a different configuration file entirely. ✨

---

🌸 FILE FORMAT 🌸

The plowshare.conf file uses an INI-style format. It's made up of six sections which may show up in any order. Each section may contain lines that look like this:

[General]
    token = value
    ...
[Plowdown]
    token = value
    ...
[Plowup]
    token = value
    ...
[Plowdel]
    token = value
    ...
[Plowlist]
    token = value
    ...
[Plowprobe]
    token = value
    ...

# this is a comment

Notes, bestie, listen up:

• Sections are unordered. 🦋
• Blank lines or lines beginning with a hash character ('#') are treated as comments and ignored.
• Whitespace before and after a token or value is ignored (although a value can contain whitespace within). 👀
• Double quoting value is optional. Use them to preserve leading and trailing whitespace.

Valid tokens are always lowercase. Names are long-option command-line arguments of plowshare. For example: temp-directory for plowdown. For modules options, tokens are prepended by module name and a slash character. For example: rapidgator/auth (short-option are also possible here). 🔥

For values, no backslash interpretation is made. "\t" is a regular string with two characters, it is not a tab character. Like, it's literally just backslash and t, no cap.

Options in general section prevail over Plow* section. Options given on the command line prevail over configuration file options. Hierarchy, we love to see it. 👑

---

🎀 EXAMPLE 🎀

###
### Plowshare configuration file
###

[General]
interface = eth1
rapidshare/a = matt:4deadbeef
rapidgator/a = "matt:4 dead beef "
antigate=bc427381269d702eccc509b8849e5b0d

[Plowdown]
timeout=3600
no-overwrite=1

[Plowup]
max-retries=2
printf=Download URL: %u%nDelete   URL: %d%n
uploadmemodule/auth-free = foo@bar.com:kjguiy1581!
uploadmemodule/folder = incoming

[Plowlist]
verbose = 3

---

💜 AUTHORS 💜

Plowshare was initially written by Arnau Sanchez. See the AUTHORS file for a list of some of the many other contributors. 🫶

Plowshare is (C) 2010-2016 The Plowshare Team.

---

🌈 SEE ALSO 🌈

plowdown(1), plowup(1), plowdel(1), plowlist(1), plowprobe(1), plowmod(1).

---

okay that's the whole page bestie, you ate that 💅 This one's GPL, dated March 24, 2016, and it's the plowshare.conf(5) manual from Plowshare for Bash 4 — go forth and configure, you gorgeous nerd. 🦋✨👑