Categorygithub.com/sinameshkini/webshare
repositorypackage
0.0.0-20240707205555-684c035af60e
Repository: https://github.com/sinameshkini/webshare.git
Documentation: pkg.go.dev

# Packages

No description provided by the author

# README

WebShare

Overview

WebShare is a simple and efficient tool for sharing files over HTTP. With WebShare, you can quickly set up a web service to share a directory's contents for reading and writing data. The tool supports basic authentication for secure access, making it ideal for both local network and internet usage.

Features

  • Easy to Use: Simple command-line interface to start sharing your files.
  • Cross-Platform: Works on all major platforms.
  • Basic Authentication: Protect your shared directories with basic auth.

Installation

To install WebShare, download the executable from the GitHub Releases page corresponding to your platform.

Usage

Basic Command

To run WebShare, use the following command:

webshare -p <port> -r <path/to/read-only-directory> -w <path/to/read-write-directory>

Command-Line Options

  • -p, --port <port>: Specify the port to run the web service on (default: 8080).
  • -r, --readonly <path/to/read-only-directory>: Set the directory that can be accessed for reading.
  • -w, --readwrite <path/to/read-write-directory>: Set the directory that can be accessed for both reading and writing.
  • -U, --username <username>: Set the username for basic authentication.
  • -P, --password <password>: Set the password for basic authentication.

Example

Running WebShare on port 8080 with a read-only directory and a read-write directory:

webshare -p 8080 -r /path/to/read-only -w /path/to/read-write -U myusername -P mypassword

Accessing the Web Service

Once the service is running, you can access the shared directories from any device on the network by navigating to:

http://<your-ip>:<port>

For example, if you are running the service on localhost and port 4242, access it at:

http://localhost:4242

Preview

$ webshare -h
 __        __         _       ____    _
 \ \      / /   ___  | |__   / ___|  | |__     __ _   _ __    ___
  \ \ /\ / /   / _ \ | '_ \  \___ \  | '_ \   / _` | | '__|  / _ \
   \ V  V /   |  __/ | |_) |  ___) | | | | | | (_| | | |    |  __/
    \_/\_/     \___| |_.__/  |____/  |_| |_|  \__,_| |_|     \___|

version: 0.0.2 
Available on https://github.com/sinameshkini/webshare

        WebShare is a user-friendly application designed for quick and secure file sharing over HTTP/HTTPS. 
        It allows you to easily set up a web service that provides access to specified directories for both 
        reading and writing data. With cross-platform compatibility and support for basic authentication, WebShare 
        ensures that your files can be accessed securely from any device on your local network or over the internet.
        Whether you need to share files for collaboration or distribute data efficiently,
        WebShare offers a straightforward solution with minimal setup.

Usage:
  webshare [flags]

Flags:
  -h, --help               help for webshare
  -P, --password string    Set the password for basic authentication.
  -p, --port int           Specifies the port number on which the web service will run. (default 4242)
  -r, --readonly string    Set the directory that can be accessed for reading. (default ".")
  -w, --readwrite string   Set the directory that can be accessed for both reading and writing.
  -U, --username string    Set the username for basic authentication.

Contributing

Contributions are welcome! Feel free to submit issues or pull requests to improve the project.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgements

Thanks to all the contributors who have helped make WebShare better.