Welcome to Pesterchum 3.41! ============================= ## FOR NEW USERS This modification of Pesterchum is intended for people who are already familiar with using the base client. If you aren't, please check the standard build's [documentation][doc]. [doc]: https://github.com/illuminatedwax/pesterchum/blob/master/README.mkdn ## FOR EVERYONE ELSE Greetings! This is a modification of Pesterchum, made because Pesterchum is effectively no longer maintained, that is intended to fix a number of issues. The code used as a base is a newer version of Pesterchum than the one in circulation, and thus has plenty of useful features that can be found in the [CHANGELOG][changes]. In addition, there are other features and improvements that have been made, and there are many more planned. Check the [TODO list][todo-done] to see what's been fixed, as well as what's [planned][todo-upcoming]. [changes]: https://github.com/karxi/pesterchum/blob/master/CHANGELOG.mkdn [todo-done]: https://github.com/karxi/pesterchum/blob/master/TODO.mkdn#tododone [todo-upcoming]: https://github.com/karxi/pesterchum/blob/master/TODO.mkdn#features ### Installation There isn't a lightweight installer yet, but the steps aren't all that difficult. #### Pitfalls * If you're on a 64-bit system (most are these days), use those links. You can also use the 32 bit versions, if you choose, but you *cannot* mix them. * If you're on a 32-bit system but use the 64-bit installers, you'll get an error along the lines of "not a valid Win32 application", or the installer will simply fail. * This version of Pesterchum does not come compiled as an executable, and thus does not have Python/PyQt4 packaged with it. Those are necessary for Pesterchum to run, so you have to install them manually. #### First-Time Install * Download links are for Windows, but a quick Google search will find everything necessary. 1. Install Python 2.7 or higher if you don't already have it: * [32 bit][python2-32] * [64 bit][python2-64] Be *sure* to add Python to the PATH if asked to do so during installation. It means Python will be usable from the console, which is necessary for this to run. 2. Install PyQt4: * [32 bit][pyqt4-32] * [64 bit][pyqt4-64] 3. (LINUX) Install pygame: * [pygame download page][pygame-dl] You don't need to install this if you're using Windows; sound should work fine without it. 4. Download Pesterchum: * [Download from main branch][pchum-zip] 5. Unzip Pesterchum somewhere easily-accessible. 6. **If you have any custom themes**, copy/paste them into the 'themes' folder. You can find this in `%APPDATA%/Local/pesterchum`. Oftentimes it doesn't exist, so you'll have to make it and copy the custom themes into it. __If that doesn't work:__ You can also copy the missing themes into the 'themes' folder of the version you just unzipped. **Don't overwrite any files** if you do this - the themes used by this have been updated, and the older default themes may break when used. 7. Run Pesterchum! How you do this depends on the OS: * (WINDOWS) Run `w32-run-pchum.bat`. * (LINUX) Run `./pesterchum`, preferably via terminal. Note that this is made to provide debugging information - so that if errors come up, they can be reported to me, and I can fix them. [python2-32]: https://www.python.org/ftp/python/2.7.12/python-2.7.12.msi [python2-64]: https://www.python.org/ftp/python/2.7.12/python-2.7.12.amd64.msi [pyqt4-32]: http://sourceforge.net/projects/pyqt/files/PyQt4/PyQt-4.11.4/PyQt4-4.11.4-gpl-Py2.7-Qt4.8.7-x32.exe [pyqt4-64]: http://sourceforge.net/projects/pyqt/files/PyQt4/PyQt-4.11.4/PyQt4-4.11.4-gpl-Py2.7-Qt4.8.7-x64.exe [pygame-dl]: http://www.pygame.org/download.shtml [pchum-zip]: https://github.com/karxi/pesterchum/archive/master.zip #### Upgrading Just re-download the [Pesterchum zip][pchum-zip] and extract it over your old installation, replacing everything that was already there. That's all there is to it! #### Having Problems? I can't offer much help in this regard; if you're getting errors, feel free to try to contact me, but if you're having trouble with the installers, there's little I can do. [How to install Python][howtogetpython] might help; failing that, Google saves lives. [howtogetpython]: http://www.howtogeek.com/197947/how-to-install-python-on-windows/ SMILIES ------- None of the smilies have changed or been added, yet; this list is kept for posterity and easy reference. * `: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:`