servepass 0.1.0__tar.gz

servepass-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fulvio Favilla
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

servepass-0.1.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: servepass
+Version: 0.1.0
+Summary: LAN file server with password protection. Like python -m http.server but with auth
+Author-email: Fulvio Favilla <contact@fulvio.sh>
+License: MIT License
+        
+        Copyright (c) 2026 Fulvio Favilla
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/fulviofavilla/servepass
+Project-URL: Repository, https://github.com/fulviofavilla/servepass
+Project-URL: Issues, https://github.com/fulviofavilla/servepass/issues
+Keywords: http,server,lan,file-sharing,auth,privacy
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# servepass
+
+Serve files on your LAN with a token. That's it.
+
+```
+pipx install servepass
+servepass
+```
+
+---
+
+You know `python -m http.server`. It's great for quick file sharing on a local network. The problem is it has zero authentication, so anyone on the same network can grab whatever you're serving.
+
+`servepass` fixes that. Same zero-config philosophy, but with a token-protected URL. Run it, get a link, share it. No accounts, no cloud, no telemetry.
+
+## Install
+
+```bash
+pipx install servepass
+```
+
+Or with pip:
+
+```bash
+pip install servepass
+```
+
+Requires Python 3.8+. No external dependencies.
+
+## Usage
+
+```bash
+# Serve current directory
+servepass
+
+# Serve a specific path
+servepass ./downloads
+
+# Custom port
+servepass --port 9090
+
+# No authentication
+servepass --no-auth
+```
+
+Every time you run servepass, a fresh token is generated. You get a URL and an optional QR code in the terminal:
+
+```
+  Serving:  /home/user/downloads
+  Network:  http://192.168.1.42:8080/?token=a3f9b2c1
+  Token:    a3f9b2c1
+
+  Ctrl+C to stop
+```
+
+Open the URL in any browser on your network and you're in. Scan the QR code to open it directly on your phone.
+
+## QR code
+
+The QR code is printed automatically if the `qrcode` package is installed:
+
+```bash
+pip install qrcode
+```
+
+Without it, servepass works normally and just shows the URL.
+
+## Known limitations
+
+servepass uses a token in the URL over plain HTTP. The token is not encrypted in transit. This is fine for a trusted local network. It is not a substitute for HTTPS or VPN on public or untrusted networks.
+
+If you're on public WiFi, use something else.
+
+## Who this is for
+
+* You're on a trusted LAN (home, office, workshop) and want to share files quickly
+* You want to download files on your phone without cables or cloud storage
+* You don't want to expose an unauthenticated HTTP server to everyone on the network
+* You want something lightweight with zero setup time
+
+## Comparison
+
+| | servepass | python -m http.server | filebrowser |
+|---|---|---|---|
+| Authentication | Token | No | Yes |
+| Install | `pipx install servepass` | Built-in | Binary + config |
+| Dependencies | None | None | None |
+| LAN IP detection | Yes | No | Yes |
+| QR code | Optional | No | No |
+| File upload | Planned | No | Yes |
+
+## Roadmap
+
+- [x] Serve with token auth
+- [x] Auto-detect LAN IP
+- [x] QR code in terminal (optional)
+- [ ] `--token` flag to set a fixed token
+- [ ] HTTPS with self-signed cert
+- [ ] File upload via browser
+
+## License
+
+MIT

servepass-0.1.0/README.md

@@ -0,0 +1,103 @@
+# servepass
+
+Serve files on your LAN with a token. That's it.
+
+```
+pipx install servepass
+servepass
+```
+
+---
+
+You know `python -m http.server`. It's great for quick file sharing on a local network. The problem is it has zero authentication, so anyone on the same network can grab whatever you're serving.
+
+`servepass` fixes that. Same zero-config philosophy, but with a token-protected URL. Run it, get a link, share it. No accounts, no cloud, no telemetry.
+
+## Install
+
+```bash
+pipx install servepass
+```
+
+Or with pip:
+
+```bash
+pip install servepass
+```
+
+Requires Python 3.8+. No external dependencies.
+
+## Usage
+
+```bash
+# Serve current directory
+servepass
+
+# Serve a specific path
+servepass ./downloads
+
+# Custom port
+servepass --port 9090
+
+# No authentication
+servepass --no-auth
+```
+
+Every time you run servepass, a fresh token is generated. You get a URL and an optional QR code in the terminal:
+
+```
+  Serving:  /home/user/downloads
+  Network:  http://192.168.1.42:8080/?token=a3f9b2c1
+  Token:    a3f9b2c1
+
+  Ctrl+C to stop
+```
+
+Open the URL in any browser on your network and you're in. Scan the QR code to open it directly on your phone.
+
+## QR code
+
+The QR code is printed automatically if the `qrcode` package is installed:
+
+```bash
+pip install qrcode
+```
+
+Without it, servepass works normally and just shows the URL.
+
+## Known limitations
+
+servepass uses a token in the URL over plain HTTP. The token is not encrypted in transit. This is fine for a trusted local network. It is not a substitute for HTTPS or VPN on public or untrusted networks.
+
+If you're on public WiFi, use something else.
+
+## Who this is for
+
+* You're on a trusted LAN (home, office, workshop) and want to share files quickly
+* You want to download files on your phone without cables or cloud storage
+* You don't want to expose an unauthenticated HTTP server to everyone on the network
+* You want something lightweight with zero setup time
+
+## Comparison
+
+| | servepass | python -m http.server | filebrowser |
+|---|---|---|---|
+| Authentication | Token | No | Yes |
+| Install | `pipx install servepass` | Built-in | Binary + config |
+| Dependencies | None | None | None |
+| LAN IP detection | Yes | No | Yes |
+| QR code | Optional | No | No |
+| File upload | Planned | No | Yes |
+
+## Roadmap
+
+- [x] Serve with token auth
+- [x] Auto-detect LAN IP
+- [x] QR code in terminal (optional)
+- [ ] `--token` flag to set a fixed token
+- [ ] HTTPS with self-signed cert
+- [ ] File upload via browser
+
+## License
+
+MIT

servepass-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "servepass"
+version = "0.1.0"
+description = "LAN file server with password protection. Like python -m http.server but with auth"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [{ name = "Fulvio Favilla", email = "contact@fulvio.sh" }]
+keywords = ["http", "server", "lan", "file-sharing", "auth", "privacy"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Utilities",
+]
+requires-python = ">=3.8"
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/fulviofavilla/servepass"
+Repository = "https://github.com/fulviofavilla/servepass"
+Issues = "https://github.com/fulviofavilla/servepass/issues"
+
+[project.scripts]
+servepass = "servepass.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["servepass*"]

servepass-0.1.0/servepass/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

servepass-0.1.0/servepass/__main__.py

@@ -0,0 +1,241 @@
+"""
+servepass -- serve files on the LAN with token auth.
+
+Nothing fancy. No dependencies. Just stdlib and a link.
+"""
+
+import argparse
+import json
+import os
+import secrets
+import signal
+import socket
+import sys
+from http.server import SimpleHTTPRequestHandler, HTTPServer
+from pathlib import Path
+from urllib.parse import urlparse, parse_qs
+
+
+CONFIG_DIR = Path.home() / ".servepass"
+CONFIG_FILE = CONFIG_DIR / "config"
+DEFAULT_PORT = 8080
+
+
+# ---------------------------------------------------------------------------
+# QR code -- pure stdlib, no external deps
+# ---------------------------------------------------------------------------
+
+def _qr_terminal(url):
+    """
+    Print a QR code for the given URL using Unicode block characters.
+    Requires the 'qrcode' package. If not installed, silently skips.
+    This is intentionally optional -- the URL is always printed anyway.
+    """
+    try:
+        import qrcode
+        qr = qrcode.QRCode(border=1)
+        qr.add_data(url)
+        qr.make(fit=True)
+        matrix = qr.get_matrix()
+        print()
+        for i in range(0, len(matrix) - 1, 2):
+            row = "  "
+            for j in range(len(matrix[i])):
+                top = matrix[i][j]
+                bot = matrix[i + 1][j] if i + 1 < len(matrix) else False
+                if top and bot:
+                    row += "\u2588"  # full block
+                elif top:
+                    row += "\u2580"  # upper half
+                elif bot:
+                    row += "\u2584"  # lower half
+                else:
+                    row += " "
+            print(row)
+        print()
+    except ImportError:
+        # qrcode not installed, no problem -- URL is printed in the banner
+        pass
+
+
+# ---------------------------------------------------------------------------
+# Network
+# ---------------------------------------------------------------------------
+
+def get_lan_ip():
+    """Best-effort local IP detection. Falls back to 127.0.0.1 if it fails."""
+    try:
+        # connect to an external address but don't actually send anything
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        s.connect(("8.8.8.8", 80))
+        ip = s.getsockname()[0]
+        s.close()
+        return ip
+    except Exception:
+        return "127.0.0.1"
+
+
+# ---------------------------------------------------------------------------
+# Token generation
+# ---------------------------------------------------------------------------
+
+def generate_token():
+    """8 hex chars -- short enough to type, long enough to not guess."""
+    return secrets.token_hex(4)
+
+
+# ---------------------------------------------------------------------------
+# Request handlers
+# ---------------------------------------------------------------------------
+
+def make_token_handler(token, directory):
+    """Handler that checks for ?token=<token> on every request."""
+
+    class TokenHandler(SimpleHTTPRequestHandler):
+        def __init__(self, *args, **kwargs):
+            super().__init__(*args, directory=directory, **kwargs)
+
+        def do_HEAD(self):
+            if not self.check_token():
+                return
+            super().do_HEAD()
+
+        def do_GET(self):
+            if not self.check_token():
+                return
+            # strip token from path before serving so directory listing works
+            self.path = self._strip_token(self.path)
+            super().do_GET()
+
+        def check_token(self):
+            parsed = urlparse(self.path)
+            params = parse_qs(parsed.query)
+            supplied = params.get("token", [None])[0]
+            if supplied == token:
+                return True
+            self.send_response(403)
+            self.send_header("Content-Type", "text/plain")
+            self.end_headers()
+            self.wfile.write(b"Access denied. Missing or invalid token.")
+            return False
+
+        def _strip_token(self, path):
+            """Remove ?token=... from path so links in directory listing stay clean."""
+            parsed = urlparse(path)
+            params = parse_qs(parsed.query)
+            params.pop("token", None)
+            # rebuild query string without token
+            new_query = "&".join(f"{k}={v[0]}" for k, v in params.items())
+            return parsed.path + (f"?{new_query}" if new_query else "")
+
+        def log_message(self, format, *args):
+            print(f"  {self.address_string()}  {args[0]}  {args[1]}")
+
+    return TokenHandler
+
+
+def make_open_handler(directory):
+    """Handler with no auth, for --no-auth mode."""
+
+    class OpenHandler(SimpleHTTPRequestHandler):
+        def __init__(self, *args, **kwargs):
+            super().__init__(*args, directory=directory, **kwargs)
+
+        def log_message(self, format, *args):
+            print(f"  {self.address_string()}  {args[0]}  {args[1]}")
+
+    return OpenHandler
+
+
+# ---------------------------------------------------------------------------
+# Banner
+# ---------------------------------------------------------------------------
+
+def print_banner(directory, ip, port, token):
+    url = f"http://{ip}:{port}"
+    if token:
+        full_url = f"{url}/?token={token}"
+        print()
+        print(f"  Serving:  {os.path.abspath(directory)}")
+        print(f"  Network:  {full_url}")
+        print(f"  Token:    {token}")
+        _qr_terminal(full_url)
+    else:
+        print()
+        print(f"  Serving:  {os.path.abspath(directory)}")
+        print(f"  Network:  {url}")
+        print(f"  Auth:     disabled (--no-auth)")
+        print()
+
+    print("  Ctrl+C to stop")
+    print()
+
+
+# ---------------------------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------------------------
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="servepass",
+        description="Serve files on the LAN with token auth.",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+examples:
+  servepass                  serve current directory
+  servepass ./downloads      serve a specific directory
+  servepass --port 9090      use a custom port
+  servepass --no-auth        serve without authentication
+        """,
+    )
+    parser.add_argument(
+        "dir",
+        nargs="?",
+        default=".",
+        metavar="DIR",
+        help="directory to serve (default: current directory)",
+    )
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=DEFAULT_PORT,
+        help=f"port to listen on (default: {DEFAULT_PORT})",
+    )
+    parser.add_argument(
+        "--no-auth",
+        action="store_true",
+        help="disable authentication",
+    )
+
+    args = parser.parse_args()
+
+    directory = args.dir
+    if not os.path.isdir(directory):
+        print(f"servepass: '{directory}' is not a directory", file=sys.stderr)
+        sys.exit(1)
+
+    use_auth = not args.no_auth
+    token = generate_token() if use_auth else None
+    ip = get_lan_ip()
+
+    if use_auth:
+        handler = make_token_handler(token=token, directory=directory)
+    else:
+        handler = make_open_handler(directory=directory)
+
+    server = HTTPServer(("0.0.0.0", args.port), handler)
+
+    def handle_exit(sig, frame):
+        print("\n\n  Stopped.\n")
+        server.server_close()
+        sys.exit(0)
+
+    signal.signal(signal.SIGINT, handle_exit)
+    signal.signal(signal.SIGTERM, handle_exit)
+
+    print_banner(directory, ip, args.port, token)
+    server.serve_forever()
+
+
+if __name__ == "__main__":
+    main()

servepass-0.1.0/servepass.egg-info/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: servepass
+Version: 0.1.0
+Summary: LAN file server with password protection. Like python -m http.server but with auth
+Author-email: Fulvio Favilla <contact@fulvio.sh>
+License: MIT License
+        
+        Copyright (c) 2026 Fulvio Favilla
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/fulviofavilla/servepass
+Project-URL: Repository, https://github.com/fulviofavilla/servepass
+Project-URL: Issues, https://github.com/fulviofavilla/servepass/issues
+Keywords: http,server,lan,file-sharing,auth,privacy
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# servepass
+
+Serve files on your LAN with a token. That's it.
+
+```
+pipx install servepass
+servepass
+```
+
+---
+
+You know `python -m http.server`. It's great for quick file sharing on a local network. The problem is it has zero authentication, so anyone on the same network can grab whatever you're serving.
+
+`servepass` fixes that. Same zero-config philosophy, but with a token-protected URL. Run it, get a link, share it. No accounts, no cloud, no telemetry.
+
+## Install
+
+```bash
+pipx install servepass
+```
+
+Or with pip:
+
+```bash
+pip install servepass
+```
+
+Requires Python 3.8+. No external dependencies.
+
+## Usage
+
+```bash
+# Serve current directory
+servepass
+
+# Serve a specific path
+servepass ./downloads
+
+# Custom port
+servepass --port 9090
+
+# No authentication
+servepass --no-auth
+```
+
+Every time you run servepass, a fresh token is generated. You get a URL and an optional QR code in the terminal:
+
+```
+  Serving:  /home/user/downloads
+  Network:  http://192.168.1.42:8080/?token=a3f9b2c1
+  Token:    a3f9b2c1
+
+  Ctrl+C to stop
+```
+
+Open the URL in any browser on your network and you're in. Scan the QR code to open it directly on your phone.
+
+## QR code
+
+The QR code is printed automatically if the `qrcode` package is installed:
+
+```bash
+pip install qrcode
+```
+
+Without it, servepass works normally and just shows the URL.
+
+## Known limitations
+
+servepass uses a token in the URL over plain HTTP. The token is not encrypted in transit. This is fine for a trusted local network. It is not a substitute for HTTPS or VPN on public or untrusted networks.
+
+If you're on public WiFi, use something else.
+
+## Who this is for
+
+* You're on a trusted LAN (home, office, workshop) and want to share files quickly
+* You want to download files on your phone without cables or cloud storage
+* You don't want to expose an unauthenticated HTTP server to everyone on the network
+* You want something lightweight with zero setup time
+
+## Comparison
+
+| | servepass | python -m http.server | filebrowser |
+|---|---|---|---|
+| Authentication | Token | No | Yes |
+| Install | `pipx install servepass` | Built-in | Binary + config |
+| Dependencies | None | None | None |
+| LAN IP detection | Yes | No | Yes |
+| QR code | Optional | No | No |
+| File upload | Planned | No | Yes |
+
+## Roadmap
+
+- [x] Serve with token auth
+- [x] Auto-detect LAN IP
+- [x] QR code in terminal (optional)
+- [ ] `--token` flag to set a fixed token
+- [ ] HTTPS with self-signed cert
+- [ ] File upload via browser
+
+## License
+
+MIT

servepass-0.1.0/servepass.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+servepass/__init__.py
+servepass/__main__.py
+servepass.egg-info/PKG-INFO
+servepass.egg-info/SOURCES.txt
+servepass.egg-info/dependency_links.txt
+servepass.egg-info/entry_points.txt
+servepass.egg-info/top_level.txt

servepass-0.1.0/servepass.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

servepass-0.1.0/servepass.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+servepass = servepass.__main__:main

servepass-0.1.0/servepass.egg-info/top_level.txt

@@ -0,0 +1 @@
+servepass

servepass-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+