Skip to content

A python based web browser with ascii image rendering capabilities!

License

Notifications You must be signed in to change notification settings

sirsru/Artiscope

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

63 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

License Status
Version 1.0.3

ARTISCOPE

About Artiscope

Artiscope is a python based ascii internet browser capable of rendering art from websites and allowing you to browse further through the website. This project is meant to be lightweight, with the ultimate goal being able to use a browser on a pi zero at a fast speed with a useable interface and results! This feature rich browser even comes with a built in update manager that automatically downloads the newest version of the browser!

warning

some images may not be the most recent ones!

image

Table of contents

about
examples
install
running Artiscope
settings
how to use
updates

examples

Here are some example websites being rendered. websites in this order:

github.com

python.org

newgrounds.com

github

python.org

newgrounds.com

install

Simple way

Now after I Had to install everything multiple times it got pretty annoying, so I made launch files for this browser, I dont know why anyone would use it on windows but thats here too.

MacOS or Linux launch the browser using launch.sh
Make sure to make the file an executable file!

Windows launch browser using launch.bat

Hard way

If you dont trust my .bat and .sh files you can just DIY the setup and launch process.

To install and use Artiscope you need to run these commands.

git clone https://github.com/sirsru/Artiscope.git

cd Artiscope

python3 -m venv venv

windows venv\Scripts\activate

linux and macos source venv/bin/activate

pip install -r requirements.txt
python3 browser.py

If you encounter any errors with installing python dependencies use the following

pip install requests pip install beautifulsoup4 pip install Pillow

How to run

After downloading Artiscope and closing it, if you wish to start it again you need to run these commands to start the python environment.

cd Artiscope

windows venv\Scripts\activate

linux and macos source venv/bin/activate

python3 browser.py

After the original install all updates done to this repository can be done from inside the browser by going to info and updates and selecting option 1.

settings

The settings menu for Artiscope can be accessed from the main menu, in which you can change the ascii image resolution and size, allowed image formats, and similar image toggle.

image

How to use

Go to link # - input a links number that was output earlier

Enter another URL - enter a different URL

Go back to the Main Menu - goes back to the homescreen with settings and other options

Browse the web - prompts you for a URL along with other options

Setting - allows you to change options in the browser like themes and emoji compatibility

Info and updates - shows you the current version of your browser, allows you to check the newest version of the browser, and download the latest version!

updates

Last but not least we have the updates! There is a built in option to update or check if you are up to date in Artiscope! All you have to do to install a new update is go to info and updates and choose Update by cloning github repo or Check for update. You do need to be connected to the internet to update the browser, but lets be honest, what are you using a browser for without internet?

About

A python based web browser with ascii image rendering capabilities!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published