https://github.com/ssddanbrown/webby
MIGRATED TO CODEBERG
https://github.com/ssddanbrown/webby
livereload webby webserver windows
Last synced: 7 months ago
JSON representation
MIGRATED TO CODEBERG
- Host: GitHub
- URL: https://github.com/ssddanbrown/webby
- Owner: ssddanbrown
- Archived: true
- Created: 2016-04-09T20:34:59.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2019-12-27T02:01:44.000Z (over 6 years ago)
- Last Synced: 2025-02-10T20:32:49.761Z (over 1 year ago)
- Topics: livereload, webby, webserver, windows
- Language: Go
- Homepage: https://codeberg.org/danb/webby
- Size: 104 KB
- Stars: 16
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Webby
A windows-focused tiny static web server app written in go. It features HTML file live-reload functionality built in which will also dynamically reload linked CSS files.
On windows, Webby sits in the windows taskbar. When clicked the management interface will open via a browser. You can exit webby by right-clicking this icon.
My experience of writing in Go is limited so there's likely to be some inefficiencies & bugs.
## Installing and usage
To install webby simply download the `webby.exe` file from the [latest release here](https://github.com/ssddanbrown/webby/releases/latest) and place somewhere in your system.
There are a few ways to use the `webby.exe` program:
1. Set webby as the default HTML file program (Recommended):
* Right click a HTML file.
* "Open with" > "Choose another app".
* Scroll to bottom > "More Apps".
* Check "Always use this app" checkbox.
* Scroll to bottom > "Look for another app on this PC".
* Select the `webby.exe` file.
2. Drag HTML files onto the `webby.exe` file.
3. From the command line, execute `webby.exe` followed by a html file you want to open:
```shell
webby.exe hello.html
```
When running for the first time you may get a 'Windows Smartscreen' warning.
## Security Considerations
When ran, Webby makes the entire directory structure below the file/folder location it's used available on a port between `8000` & `9000`. Anyone with access to that port on your pc could sniff around and search for files on your system.
Upon the above, Someone with access to port `35729` on your machine could create new servers at any directory they want then access via the above method.
It is recommended to only use webby behind a firewall on networks you trust due to the above security concerns.
## Project Goals
* Should be focused on static HTML/CSS/JS development.
* Should be super simple to use.
* Should be lightweight.
## Libs used
These awesome libraries have been used in webby:
* github.com/fatih/color
* github.com/howeyc/fsnotify
* golang.org/x/net/websocket
* github.com/GeertJohan/go.rice
* github.com/akavel/rsrc
* github.com/lxn/walk
* github.com/livereload/livereload-js
## License
Webby is licensed under the [MIT License](https://opensource.org/licenses/MIT).