pesterchum/README.md
2021-08-09 08:47:05 +02:00

4.2 KiB

PESTERCHUM

Pesterchum is an instant messaging client copying the look and feel of clients from Andrew Hussie's webcomic Homestuck. Maintained repository of ghostDunk's Pesterchum. Prompts the user to choose a server at launch (irc.pesterchum.xyz by default).

This repository builds on (and was mirrored from!) from pesterchum-karxi + Hydrothermal's nickserv fix.

Check out CHANGELOG.md file to see what's changed! Check out TODO.md to see this repo's current goals >:3c

GUIDES

The old READMEs and guides can be viewed in the docs folder. I'd highly recommend you take a look at the following files if you're new to Pesterchum:

Guides for python quirks and themes are also in the docs folder. If you want to set up a gradient quirk you should take a look at these guides.

INSTALATION

Download the appropriate release for your platform from releases. If you're on windows you can use the installer, for a manual install download the zip file and extract it to any directory, and run the executable : )

Because of the nature of cx_freeze & pyinstaller, some libraries (like glibc) are dynamically linked. If the executeable for your platform is uncompatible with the version of your operating system, see the next section for running Pesterchum directly.

RUNNING & BUILDING

Here's a quick guide on what to do to run Pesterchum from the command line, and to build it if you so desire (that is, generating an executable). Running Pesterchum directly or building Pesterchum yourself is not required to run it!!! This is only relevant if you know what you're doing >:3c

If you have Python and Pesterchum's dependencies installed, you can simply run Pesterchum from the commandline with python pesterchum.py.

REQUIREMENTS:

PYTHON DEPENDENCIES

You can install them with Python's pip or your package manager if you're on linux :)

PYINSTALLER BUILDING

My preferred method of generating binary releases on Windows and Linux, MacOS doesn't seem to work for me. NOTE: pyinstaller builds seem to get flagged as malware. python pyinstaller.py

CX_FREEZE BUILDING

Windows:

python setup.py build or python setup.py bdist_msi

Mac:

python setup.py build

SMILIES

Just for easy reference. :3 (Taken from docs/README-karxi.mkdn)

  • :rancorous:
  • :apple:
  • :bathearst:
  • :cathearst:
  • :woeful:
  • :pleasant:
  • :blueghost:
  • :slimer:
  • :candycorn:
  • :cheer:
  • :duhjohn:
  • :datrump:
  • :facepalm:
  • :bonk:
  • :mspa:
  • :gun:
  • :cal:
  • :amazedfirman:
  • :amazed:
  • :chummy:
  • :cool:
  • :smooth:
  • :distraughtfirman:
  • :distraught:
  • :insolent:
  • :bemused:
  • :3:
  • :mystified:
  • :pranky:
  • :tense:
  • :record:
  • :squiddle:
  • :tab:
  • :beetip:
  • :flipout:
  • :befuddled:
  • :pumpkin:
  • :trollcool:
  • :jadecry:
  • :ecstatic:
  • :relaxed:
  • :discontent:
  • :devious:
  • :sleek:
  • :detestful:
  • :mirthful:
  • :manipulative:
  • :vigorous:
  • :perky:
  • :acceptant:
  • :olliesouty:
  • :billiards:
  • :billiardslarge:
  • :whatdidyoudo: