AsciiFarter 2

Release version 2.3 alpha

Document revision from 02.28.2026

“2”? what? theres a first one?

Yes, and its available at yeetshttps/asciiFarter

What does it do?

AsciiFarter takes Ascii Art from a website and prints it in your terminal.

It does this by looking at a file named status.xml and uses the information from the file to get a list of URLs for Ascii Arts and other various info.

AsciiFarter 2 is designed to be able to be integrated in things like Discord bots or other random scripts, see source/fartlib/README.md for more info about this.

How do I use it?

To run, AsciiFarter needs the Python modules bs4(BeatifulSoup) and lxml installed. This should usually be as easy as running pip to install them:

pip3 install bs4 lxml

Getting AsciiFarter on your system so you can run it

Right now, you can only run it by cloning the repo:

git clone https://github.com/yeetssite/asciifarter.git

Hopefully, if I remember, there will eventually be an installer script that lets you actually install AsciiFarter to run it outside of the repo.

To run AsciiFarter from the repo

Go to the folder with AsciiFarter in it:

cd ./asciifarter/source/

Then, run AsciiFarter:

python ./asciiFarter2.py

What AsciiFarter will do

By default, AsciiFarter prints a random Ascii Art when you run it. To view what AsciiFarter can do, run:

~/$ python ./asciifarter/source/asciiFarter2.py help

Other stuff

Troubles? Bugs? Open an issue.

This repo features 100% human-written code, written with some assistance from some google searches, but never generated by AI. Why? AI is stupid, just look at Windows 11.

This repo and it’s code are licensed under GPL-3.0. See here or https://www.gnu.org/licenses/gpl-3.0:

        AsciiFarter: make your terminal shart™
        Copyright (C) 2024-2026 Jacob Haché(mangolover1899, itsyeetsup)
        This program is free software: you can redistribute it and/or modify
        it under the terms of the GNU General Public License as published by
        the Free Software Foundation, either version 3 of the License, or
        (at your option) any later version.

        This program is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        GNU General Public License for more details.

        You should have received a copy of the GNU General Public License
        along with this program.  If not, see <https://www.gnu.org/licenses/>.