Parlerbot is a client library for Parler – the largest free speech social network.
Defend freedom of speech and FIGHT SOCIALISM!
You'll need at least Node.js v8.17.0 (Carbon LTS) to run Parlerbot – although we recommend using the latest available stable version (currently v14.2.0).
First, run npm install -g @hack-r/Parlerbot to fetch the software
and all required dependencies. After installation completes, run Parlerbot
to see usage information.
Then, log in to Parler using an ordinary web browser. Use your browser's
development tools and/or cookie storage interface to find Parler's MST
(Master Session Token) and JST (a short-lived session token). Use the
init subcommand to create an authorization file using the MST and JST values
from your browser. If your browser supplies you with URI-encoded versions of
these values, you should decode them prior to use to avoid duplicate HTTPS
requests and/or warning messages from the tool. Any automation of the above
login process is unlikely to be accepted.
Results for all subcommands are printed to standard output as a JSON-encoded array of objects.
Parlerbot <command>
Commands:
Parlerbot init Create an authorization file
Parlerbot feed Fetch your own feed of posts
Parlerbot profile Fetch a user profile
Parlerbot post Fetch a single post by identifier
Parlerbot posts Fetch all posts for a user
Parlerbot following Fetch all users followed by a user
Parlerbot followers Fetch all followers of a user
Parlerbot comments Fetch all comments for a user, post, or comment
Parlerbot tag Fetch all posts mentioning a hashtag
Parlerbot votes Fetch all votes made by a user
Parlerbot write Post a new message to your account
Parlerbot delete Delete an existing message from your account
Parlerbot follow Follow a user
Parlerbot unfollow Unfollow an already-followed user
Parlerbot mute Mute a user
Parlerbot news Fetch your own affiliate news feed
Parlerbot moderation Fetch your list of comments for moderation
Parlerbot write_comment Write a new comment to a post based on -i (id)
Options:
--version Show version number [boolean]
-h, --help Show help [boolean]
-c, --credentials MST/JST tokens [string] [default: "config/auth.json"]
-o, --credentials-out Output file for client credentials [string]
-l, --ignore-last Rely solely upon time comparisons [boolean]
-n, --no-delay Disable the failsafe rate-limiter [boolean]
-p, --page-limit Set the page size limit [number]
-v, --verbose Print debug information to stderr [boolean]
-q, --quiet Print less information to stderr [boolean]
-s, --silent Print absolutely no information to stderr [boolean]
-e, --expand Expand specific UUID types [array] [default: "all"]
Parlerbot init
Create an authorization file
Options:
-o, --credentials-out Output file for client credentials [string]
--mst The MST master session token [string] [required]
--jst The shorter-lived JST session token [string] [required]
Parlerbot posts
Fetch all posts for a user
Options:
-u, --username The name of the user [string]
Parlerbot comments
Fetch all comments for a user, post, or comment
Options:
-u, --username The name of the user [string]
-i, --identifier The unique identifier of the post [string]
-r, --replies The unique identifier of the comment [string]
Parlerbot tag
Fetch all posts mentioning a hashtag
Options:
-t, --tag The hashtag, without the hash sign [string] [required]
Parlerbot write
Post a new message to your account
Options:
-t, --text The textual content to post [string] [required]
Parlerbot delete
Delete an existing message from your account
Options:
-i, --identifier The unique identifier of the post [string] [required]
This repository seeks to document the design of Parler as accurately and concisely as possible. Parler is of interest to researchers, political campaigns, civic engagement groups, law enforcement, anti-discrimination groups, and the public at large. The free speech conveyed in this repository is of timely and widespread public interest.
If you choose to use this speech as part of an activity, please ensure your activity is ethical and legal within your jurisdiction. The author of this work of speech cannot, will not, and has no responsibility to control the behavior of others – in any jurisdiction, on any of Jupiter's mighty moons, or anywhere within the known universe – past, present, or future.
Due to the specific nature and quality of Parler's engineering design, the speech contained within this repository is the sole product of unrelated industry experience and third-party documentation. No act of disassembly, decompilation, reverse engineering, trade secret violation – nor any other prohibited act – was necessary to create the work contained herein.
"Communication does not lose constitutional protection as 'speech' simply because it is expressed in the language of computer code. Mathematical formulae and musical scores are written in 'code,' i.e. symbolic notations not comprehensible to the uninitiated, and yet both are covered by the First Amendment. If someone chose to write a novel entirely in computer object code by using strings of 1’s and 0’s for each letter of each word, the resulting work would be no different for constitutional purposes than if it had been written in English." – DMCA, Universal City Studios v. Corley, FN191: 273 F.3d 429, 60 USPQ2d 1953 (2nd Cir. 2001)
Congress shall make no law respecting an establishment of religion, or prohibiting the free exercise thereof; or abridging the freedom of speech, or of the press; or the right of the people peaceably to assemble, and to petition the Government for a redress of grievances.