Package: cheermeup
CheermeupCommand line program that plays random animal from your favorite animal subreddits!Standaloneexecutable(windows only)As a commandline app (available on windows and unix)Created byu/andohuman|@andohuman1. Getting startedThis app works by scraping videos from a some of the popular animal subreddits.If you want to run the standalone binary (windows only), download it fromhere.Else if you want to install as a python module and mess with the code, stick around.2. InstallationBefore we proceed with the actual installation, consider installing this package in a virtual python environment.Installing venvInstall the virtualenv python package with the following command :-pip3 install virtualenvYou can now go ahead and create a virtual environment with the following command :-python3 -m venv YOUR_ENV_NAME/Now activate the virtual environment you just created :-On windowsYOUR_ENV_NAME\Scripts\activateOn unix systemssource YOUR_ENV_NAME/bin/activateYou can now proceed with the installation of the packageInstalling using pipYou can use the python package manager pip to install this package, although it is recommended that you install the package from source for the latest updates.Runpip3 install cheermeupInstalling from source (Recommended)Clone this repositorygit clone https://github.com/andohuman/cheermeup.gitIf you're on windows you can download the zip fromhereand extract the archive.cd into the folder and install the package by executingcd cheermeuppip3 install .Note: If you're installing on linux without virtualenv you might have to add/home/{YOUR_USERNAME}/.local/bin/to your$PATH.Run the app by executingcheermeup.Note: When you run the program for the first time (of the day by default) it may take a couple of seconds, depending on your internet connection and speed to fetch the links and cache them.If you want to scrape videos from your own subreddits you can do so with the following argumentcheermeup --subreddits SUBREDDIT_NAME SUBREDDIT_NAME SUBREDDIT_NAME ...Executecheermeup --helpfor more optionsBy default cheermeup only scrapes videos from the following subreddits:-babyelephantgifs
partyparrot
animalsbeingjerks
animalsbeingderps
animalsbeingconfused
whatswrongwithyourdog
startledcats
zoomiesIf you would like to checkout more options head over tor/MadeMeSmile's list of good subreddits and add your own subreddits with the--subredditsargument.It has to be mentioned that the more subreddits you add the slower it will take if the app is caching before playing the video (usually the first run of the day).If you're seeing the same videos over and over again and would like to refresh the cache run the app with the--force-rewrite-cacheflag.2.1 (optional | windows only)  Instructions to build standalone executableWe would need to install the pyinstaller python package which lets us build an executable from a given python source.Runpip3 install pyinstallercd into the src directory and executepyinstaller -w -F cheermeup.pyThe-wflag supresses terminal window and the-Fmakes pyinstaller procduces only one single executable file
You will find the newly built binarycheermeup.exein thedistfolder.3. Improvements (help needed)Please note that this is an alpha project I put together in a couple of hours and it might not exactly be stable all the time. Feel free to raise an issue and I'll try and look into itI also want to release linux and macos binaries but pyinstaller and cx_freeze won't play well with cv2, which is a dependancy and I also don't have a mac to test this tool on. If anyone would like to help/contribute (in this regard or any other bugs you find) please issue a pull request.