Skip to content

Latest commit

 

History

History
76 lines (54 loc) · 2.36 KB

README.md

File metadata and controls

76 lines (54 loc) · 2.36 KB
Raw

GoPostStuff

GoPostStuff is a simple client for posting binaries to Usenet, written in Go. If you've seen/used [newsmangler] 1, imagine that but faster (and maybe better one day).

Features

  • Multiple server support with multiple connections per server.
  • Native TLS support so you don't need to use stunnel or equivalent frippery.
  • Fast: a basic Linode VPS can push 250Mbit of TLS-encrypted data while using 50-60% of a single CPU (Intel(R) Xeon(R) CPU E5-2680 v2 @ 2.80GHz).

Requirements

  • A working [Go installation] 2
  • A Usenet server that allows posting

Installation

  1. Initalise a directory to store Go files:

     mkdir ~/go
 export GOPATH="~/go"

  2. Get and install GoPostStuff - this will make a ~/go/bin/gopoststuff binary:

    go get github.com/obiwantje/gopoststuff
go install github.com/obiwantje/gopoststuff

  3. Copy sample.conf to ~/.gopoststuff.conf and edit the options as appropriate.

     cp sample.conf ~/.gopoststuff.conf
 nano ~/.gopoststuff.conf

  4. Run gopoststuff!

Usage

gopoststuff [-c "CONFIG"] [-d] [-g "GROUP"] [-s "SUBJECT"] [-v] file1 file2 ... fileN

  • -c "CONFIG": Use an alternate configuration file.
  • -d: Use directory posting mode. Each fileN argument must be a directory. All files in each directory will be posted using the directory name as the subject.
  • -g "GROUP": Post to GROUP instead of the global/DefaultGroup config option.
  • -s "SUBJECT": Use subject posting mode. All files will be posted using SUBJECT as the subject. Directories supplied as arguments are always recursed into.
  • -v: Verbose mode. This will spam a lot of extra debug information.
  • -version: prints the current gps version.
  • -nzb "test.nzb": Create nzb file after posting.
  • -pass "PASSWORD": Add password for rar archives to nzb head.
  • -server "SERVER": Use specified server to post.

Example

Let's say you have some files that you would like to post:

  • Cool Files/
    • cool.rar
    • cool.r00
    • cool.r01
    • cool.sfv

You can post it with the subject "Cool Files" like so:

gopoststuff -d "Cool Files"

or with a different subject like so:

gopoststuff -s "This is a different subject" "Cool Files"