v0.6.4: daemon lifecycle, clipboard, network, docs fixes

.gitignore

@@ -17,7 +17,7 @@
 # Output directories
 .localgo_security/
 downloads/
-scripts/*.log
+*.log
 
 # Dependency directories (if vendoring)
 vendor/
@@ -38,7 +38,8 @@ Thumbs.db
 coverage.*
 
 
-/config
+/mise.toml
+config
 test
 dist/
 .coverage/

README.md

@@ -37,12 +37,12 @@ A Go implementation of the LocalSend v2.1 protocol for secure, cross-platform fi
 
 ### Installation
 
-#### Online (macOS, Linux)
+#### Quick install (macOS, Linux)
 ```bash
 curl -fsSL https://bethropolis.github.io/localgo/install.sh | bash
 ```
 
-####  User installation (recommended)
+####  User installation
 ```bash
 # clone repo
 git clone https://github.com/bethropolis/localgo.git
@@ -69,6 +69,17 @@ scoop bucket add bethropolis https://github.com/bethropolis/scoop-bucket
 scoop install localgo
 ```
 
+#### using docker / podman
+```bash
+mkdir -p localgo/downloads localgo/config
+docker pull ghcr.io/bethropolis/localgo:latest
+docker run -d \
+  -p 53317:53317 \
+  -v ./localgo/config:/app/config \
+  -v ./localgo/downloads:/app/downloads \
+  ghcr.io/bethropolis/localgo:latest
+```
+
 > [!NOTE]
 > more install options in [installation documentation](docs/GETTING_STARTED.md)
 
@@ -99,7 +110,7 @@ localgo share --file document.pdf
 
 ### Docker and Podman
 
-For full details — deployment, macvlan networking, read-only root filesystem, watchtower, and more — see the [container documentation](docs/CONTAINER.md).
+For full details on deployment, macvlan networking, read-only root filesystem, watchtower, and more, see the [container documentation](docs/CONTAINER.md).
 
 ## Configuration
 
@@ -117,6 +128,17 @@ For full details — deployment, macvlan networking, read-only root filesystem,
 | `LOCALSEND_AUTO_ACCEPT` | false | Auto-accept incoming files without prompting |
 | `LOCALSEND_NO_CLIPBOARD` | false | Save incoming text as a file instead of clipboard |
 | `LOCALSEND_LOG_LEVEL` | info | Log verbosity (debug/info/warn/error) |
+| `LOCALSEND_HISTORY` | (auto) | Path to transfer history file |
+| `LOCALSEND_EXEC` | — | Shell command to run after each received file |
+| `LOCALSEND_QUIET` | false | Minimal output mode |
+| `LOCALSEND_CONCURRENCY` | 4 | Max parallel upload workers |
+| `LOCALSEND_MULTICAST_INTERFACE` | (all) | Network interface for multicast |
+| `LOCALSEND_SHELL` | (auto) | Shell prefix for exec hooks |
+| `LOCALSEND_TLS_CERT` | — | Custom TLS certificate path |
+| `LOCALSEND_TLS_KEY` | — | Custom TLS private key path |
+| `LOCALSEND_NOTIFICATION_CMD` | (auto) | Custom notification command |
+| `LOCALSEND_MAX_BODY_SIZE` | 0 | Max request body size (0 = unlimited) |
+| `LOCALSEND_SECURITY_DIR` | (auto) | Security context directory |
 
 ### Example
 
@@ -136,9 +158,12 @@ localgo serve
 | `discover` | Find devices via multicast |
 | `scan` | Find devices via HTTP scan |
 | `send` | Send files to a device |
-| `history`| Show file transfer history log |
 | `info` | Show device information |
 | `devices` | List discovered devices |
+| `history` | Show transfer history log |
+| `stop` | Stop a running daemon |
+| `config` | Manage configuration (get/set/list/path) |
+| `version` | Show version information |
 
 Run `localgo help` for more options.
 
@@ -180,7 +205,7 @@ Want to build on top of LocalGo or contribute?
 
 ## Contributing
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+Contributions are welcome! Please feel free to submit a Pull Request or report an issue.
 
 ## License
 

cmd/localgo/cmd/config.go

@@ -3,9 +3,11 @@ package cmd
 import (
 	"fmt"
 	"os"
+	"path/filepath"
 	"strconv"
 	"strings"
 
+	"github.com/bethropolis/localgo/pkg/help"
 	"github.com/spf13/cobra"
 	"github.com/spf13/viper"
 )
@@ -90,7 +92,7 @@ var configSetCmd = &cobra.Command{
 			configPath = os.ExpandEnv("$HOME/.config/localgo/config.yaml")
 		}
 
-		if err := os.MkdirAll(strings.TrimSuffix(configPath, "/config.yaml"), 0700); err != nil {
+		if err := os.MkdirAll(filepath.Dir(configPath), 0700); err != nil {
 			return fmt.Errorf("failed to create config directory: %w", err)
 		}
 
@@ -167,5 +169,10 @@ func init() {
 	configCmd.AddCommand(configSetCmd)
 	configCmd.AddCommand(configListCmd)
 	configCmd.AddCommand(configPathCmd)
+	configCmd.SetHelpFunc(func(cmd *cobra.Command, args []string) {
+		if h := help.GetCommandHelp("config"); h != nil {
+			help.ShowCommandHelp(*h)
+		}
+	})
 	rootCmd.AddCommand(configCmd)
 }

cmd/localgo/cmd/daemon_unix.go

@@ -0,0 +1,57 @@
+//go:build !windows
+
+package cmd
+
+import (
+	"fmt"
+	"os"
+	"os/exec"
+	"path/filepath"
+	"strconv"
+	"strings"
+	"syscall"
+)
+
+func daemonize() error {
+	// Check if daemon is already running
+	pidPath, err := pidFilePath()
+	if err != nil {
+		return fmt.Errorf("cannot determine pid file path: %w", err)
+	}
+	if data, err := os.ReadFile(pidPath); err == nil {
+		if oldPid, err := strconv.Atoi(strings.TrimSpace(string(data))); err == nil {
+			if p, err := os.FindProcess(oldPid); err == nil && p.Signal(syscall.Signal(0)) == nil {
+				return fmt.Errorf("daemon already running (PID %d)", oldPid)
+			}
+		}
+	}
+
+	var childArgs []string
+	for _, a := range os.Args[1:] {
+		if a == "--daemon" || a == "-d" {
+			continue
+		}
+		childArgs = append(childArgs, a)
+	}
+	child := exec.Command(os.Args[0], childArgs...)
+	child.Env = append(os.Environ(), "LOCALGO_DAEMON_CHILD=1")
+	child.Stdin = nil
+	child.Stdout = nil
+	child.Stderr = nil
+	child.SysProcAttr = &syscall.SysProcAttr{Setpgid: true}
+
+	if err := child.Start(); err != nil {
+		return fmt.Errorf("failed to start daemon: %w", err)
+	}
+
+	if err := os.MkdirAll(filepath.Dir(pidPath), 0755); err != nil {
+		return fmt.Errorf("cannot create pid directory: %w", err)
+	}
+	if err := os.WriteFile(pidPath, []byte(fmt.Sprintf("%d", child.Process.Pid)), 0644); err != nil {
+		return fmt.Errorf("failed to write PID file: %w", err)
+	}
+
+	fmt.Printf("LocalGo daemon started (PID %d)\n", child.Process.Pid)
+	os.Exit(0)
+	return nil
+}

cmd/localgo/cmd/daemon_windows.go

@@ -0,0 +1,9 @@
+//go:build windows
+
+package cmd
+
+import "fmt"
+
+func daemonize() error {
+	return fmt.Errorf("daemon mode is not supported on Windows; use 'localgo serve' in a terminal or run as a background job")
+}

cmd/localgo/cmd/discover.go

@@ -99,7 +99,10 @@ var discoverCmd = &cobra.Command{
 			if ipErr == nil && len(localIPs) > 0 {
 				var scanIps []net.IP
 				for _, ip := range localIPs {
-					scanIps = append(scanIps, network.GetSubnetIPs(ip)...)
+					subnetIPs, err := network.GetUsableSubnetIPsFromIP(ip)
+					if err == nil {
+						scanIps = append(scanIps, subnetIPs...)
+					}
 				}
 				registerDto := Cfg.ToRegisterDto()
 				httpDiscoverer := discovery.NewHTTPDiscovery(nil, registerDto, nil, zap.S())

cmd/localgo/cmd/pid.go

@@ -0,0 +1,15 @@
+package cmd
+
+import (
+	"os"
+	"path/filepath"
+)
+
+// pidFilePath returns the absolute path to the daemon PID file.
+func pidFilePath() (string, error) {
+	configDir, err := os.UserConfigDir()
+	if err != nil {
+		return "", err
+	}
+	return filepath.Join(configDir, "localgo", "localgo.pid"), nil
+}

cmd/localgo/cmd/root.go

@@ -4,6 +4,8 @@ import (
 	"fmt"
 	"os"
 
+	"github.com/bethropolis/localgo/pkg/cli"
+	"github.com/bethropolis/localgo/pkg/clipboard"
 	"github.com/bethropolis/localgo/pkg/config"
 	"github.com/bethropolis/localgo/pkg/help"
 	"github.com/bethropolis/localgo/pkg/logging"
@@ -29,6 +31,13 @@ var (
 var rootCmd = &cobra.Command{
 	Use:   "localgo",
 	Short: "LocalGo - LocalSend v2.1 Protocol Implementation",
+	Run: func(cmd *cobra.Command, args []string) {
+		if versionFlag {
+			help.ShowVersion(Version, GitCommit, BuildDate)
+			return
+		}
+		cmd.Help()
+	},
 	PersistentPreRunE: func(cmd *cobra.Command, args []string) error {
 		if versionFlag {
 			help.ShowVersion(Version, GitCommit, BuildDate)
@@ -62,6 +71,13 @@ var rootCmd = &cobra.Command{
 			Cfg.Private = true
 		}
 
+		if Cfg.ClipboardWriteCmd != "" || Cfg.ClipboardReadCmd != "" {
+			clipboard.OverrideProvider(Cfg.ClipboardWriteCmd, Cfg.ClipboardReadCmd)
+		}
+		if Cfg.NotificationCmd != "" {
+			cli.SetNotificationCmd(Cfg.NotificationCmd)
+		}
+
 		return nil
 	},
 }
@@ -73,7 +89,7 @@ func Execute() {
 }
 
 func init() {
-	rootCmd.PersistentFlags().BoolVar(&versionFlag, "version", false, "Show version information")
+	rootCmd.PersistentFlags().BoolVarP(&versionFlag, "version", "v", false, "Show version information")
 	rootCmd.PersistentFlags().BoolVarP(&privateMode, "private", "p", false, "Hide device identity (alias, model) during discovery and transfer")
 	rootCmd.PersistentFlags().StringVar(&cfgFile, "config", "", "config file (default is $HOME/.config/localgo/config.yaml)")
 	rootCmd.PersistentFlags().BoolVar(&Verbose, "verbose", false, "Enable debug logging")

cmd/localgo/cmd/scan.go

@@ -66,8 +66,10 @@ var scanCmd = &cobra.Command{
 			}
 
 			for _, ip := range localIPs {
-				subnetIPs := network.GetSubnetIPs(ip)
-				ips = append(ips, subnetIPs...)
+				subnetIPs, err := network.GetUsableSubnetIPsFromIP(ip)
+				if err == nil {
+					ips = append(ips, subnetIPs...)
+				}
 			}
 
 			if !scanquiet {