Skip to content

OpenMindAmir/pylocalhost

Repository files navigation

PyLocalHost

A server for serving and rendering files in localhost + some interesting options

Description

This is a web-based file explorer and its root path is your ~/Pylocalhost directory. It is useful for serving HTML files,Ajax,PHP and every thing that needs a webserver.Its file explorer has a sweet GUI.Its simple and lightweight! Enjoy! ✔️

GUI 404

We try to make it better. You can help us too! How? By submitting your issues (if you have) or making pull requests!

Prerequisites

Before installtion you need: nginx & git

If you don't have them try installing theme (Exmaple for Ubuntu):

$ sudo apt install nginx git

If you want Pylocalhost to serve and render PHP files you will also need php-fpm Version 7.0 or higher(Exmaple for Ubuntu):

$ sudo apt install php8.0 php8.0-fpm

$ sudo systemctl enable --now php8.0-fpm

Installation (Beta version)

👉 NOTE: The version below is unstable(Beta) --> Click Here for the latest stable version (1.6.1) 👈

Download preinstaller.py file which is in the repository.

You can get it from terminal using wget:

$ wget --no-dns-cache https://raw.githubusercontent.com/mwxgaf/pylocalhost/master/preinstaller.py

After that just run the file with python 3:

$ python3 preinstaller.py

In some OSs may be you must type python instead of python3

Then run the installer.py file(it will be created once you ran preinstaller.py) with python 3 under sudo:

$ sudo python3 installer.py

It will show you details. If installation was unsuccessful please submit an issue including details and your system info.

Usage

Run:

$ sudo pylh enable

And then:

$ sudo pylh start

Then go to http://pylh

It will show you anything which is in ~/Pylocalhost and always it will start automatically when you turn your computer on ✔️

Just this! ✔️

This descriptions are for starting using PyLocalHost. In user manual page(which is in PyLocalHost) you can learn using PyLocalHosts futures and options.

Update

To be honest, the installer is uninstaller and insaller! So follow the installion process to update the software!

And then run:(to prevent possible problems):

$ sudo pylh restart

Info

Used tools:

  • Python
    • Flask
    • Jinja
    • WTForms
    • GUnicorn
    • mwx
  • HTML
  • CSS
  • JavaScript
    • JSON
  • Bash script
  • Nginx
  • CodeMirror

Made by an Iranian 🇮🇷

Be comfortable to submit pull requests and issues ✔️