Add foundation for web interface, new setup wizard

.dockerignore

@@ -0,0 +1,8 @@
+.env
+.git
+.DS_Store
+tmp/
+logs/
+explo
+src/web/frontend/node_modules/
+src/web/dist/

.gitignore

@@ -0,0 +1,9 @@
+.env
+.DS_Store
+/main
+tmp/
+.air.toml
+logs/
+explo
+src/web/dist/
+src/web/frontend/node_modules/

Dockerfile

@@ -1,3 +1,10 @@
+FROM node:20-alpine AS ui-builder
+WORKDIR /app/src/web/frontend
+COPY src/web/frontend/package*.json ./
+RUN npm ci
+COPY src/web/frontend/ ./
+RUN npm run build
+
 FROM golang:1.24-alpine AS builder
 
 # Set the working directory
@@ -6,6 +13,9 @@ WORKDIR /app
 # Copy the Go source code into the container
 COPY ./ .
 
+# Copy the built React frontend into the embed path
+COPY --from=ui-builder /app/src/web/dist ./src/web/dist
+
 # Build the Go binary based on the target architecture
 ARG TARGETARCH
 RUN GOOS=linux GOARCH=$TARGETARCH go build -o explo ./src/main/
@@ -35,7 +45,9 @@ COPY src/downloader/youtube_music/search_ytmusic.py .
 
 RUN chmod +x /start.sh ./explo
 
-# Can be defined from compose as well
-ENV WEEKLY_EXPLORATION_SCHEDULE="15 0 * * 2"
+
+ENV WEB_ADDR=":7288"
+
+EXPOSE 7288
 
 CMD ["/start.sh"]

docker-compose.yaml

@@ -3,6 +3,10 @@ services:
     image: ghcr.io/lumepart/explo:latest
     restart: unless-stopped
     container_name: explo
+    ports:
+      - "7288:7288"
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
     volumes:
       - /path/to/.env:/opt/explo/.env
       - /path/to/musiclibrary/explo:/data/ # has to be in the same path you have your music system pointed to (it's recommended to put explo under a subfolder)
@@ -13,15 +17,14 @@ services:
     environment:
       - TZ=UTC # Change this to the timezone set in ListenBrainz (default is UTC)
 
-      - WEEKLY_EXPLORATION_SCHEDULE=15 00 * * 2 # Runs weekly, every Tuesday 15 minutes past midnight
-      - WEEKLY_EXPLORATION_FLAGS= # Run weekly exploration with default settings
-
-      # Uncomment _SCHEDULE and _FLAGS variables to enable fetching different playlist
-      #- WEEKLY_JAMS_SCHEDULE=30 00 * * 1 # Runs weekly, every Monday 30 minutes past midnight
-      #- WEEKLY_JAMS_FLAGS=--playlist=weekly-jams --download-mode=skip # Get tracks from weekly-jams, and only add tracks that are found locally to playlist
-
-      #- DAILY_JAMS_SCHEDULE=15 01 * * * # Runs daily, every day 15 minutes past 1PM
-      #- DAILY_JAMS_FLAGS=--playlist=daily-jams --download-mode=skip # Get tracks from daily-jams, and only add tracks that are found locally to playlist
+      # [Legacy] Schedules are managed through the web UI.
+      # These can still be set here for backwards compatibility — they will take precedence over the UI.
+      #- WEEKLY_EXPLORATION_SCHEDULE=15 00 * * 2
+      #- WEEKLY_EXPLORATION_FLAGS=
+      #- WEEKLY_JAMS_SCHEDULE=30 00 * * 1
+      #- WEEKLY_JAMS_FLAGS=--playlist=weekly-jams --download-mode=skip
+      #- DAILY_JAMS_SCHEDULE=15 01 * * *
+      #- DAILY_JAMS_FLAGS=--playlist=daily-jams --download-mode=skip
 
       # Uncomment for testing (runs explo right after launcing the container)
       #- EXECUTE_ON_START=false # Whether to run explo when starting the container (useful for testing)

docker/start.sh

@@ -1,6 +1,33 @@
 #!/bin/sh
+echo "[setup] Starting web UI..."
+# If user incorectly mounts the config path as a directory, we'll try to automatically append it to .env inside it instead of failing.
+WEB_CFG_PATH="${WEB_CFG_PATH:-/opt/explo/.env}"
+if [ -d "$WEB_CFG_PATH" ]; then
+    WEB_CFG_PATH="$WEB_CFG_PATH/.env"
+    echo "[setup] Config path is a directory, using $WEB_CFG_PATH"
+fi
+WEB_UI=true WEB_CFG_PATH="$WEB_CFG_PATH" WEB_ADDR="${WEB_ADDR:-:7288}" /opt/explo/explo &
+echo "[setup] Web UI available at http://localhost:${WEB_ADDR##*:}"
+
 echo "[setup] Initializing cron jobs..."
 
+# Load *_SCHEDULE and *_FLAGS from .env if not already set in the environment.
+# This allows the web UI to configure schedules by writing to the .env file.
+_cfg="${WEB_CFG_PATH:-/opt/explo/.env}"
+if [ -f "$_cfg" ]; then
+  while IFS= read -r _line; do
+    case "$_line" in \#*|'') continue ;; esac
+    _key="${_line%%=*}"
+    case "$_key" in
+      *_SCHEDULE|*_FLAGS)
+        if [ -z "$(printenv "$_key" 2>/dev/null)" ]; then
+          export "$_key=${_line#*=}"
+        fi
+        ;;
+    esac
+  done < "$_cfg"
+fi
+
 
 # $CRON_SHCEDULE was deprecated in v0.11.0, keeping this block for backwards compatibility
 if [ -n "$CRON_SCHEDULE" ]; then

sample.env

@@ -127,4 +127,4 @@ YOUTUBE_API_KEY=
 # Set the log level (DEBUG, INFO, WARN, ERROR) (default: INFO)
 # LOG_LEVEL=INFO
 # Set a custom HTTP timeout for music servers (in seconds) (default: 10)
-# CLIENT_HTTP_TIMEOUT=10
+# CLIENT_HTTP_TIMEOUT=10

src/client/plex.go

@@ -33,10 +33,10 @@ type Libraries struct {
 		Size      int    `json:"size"`
 		AllowSync bool   `json:"allowSync"`
 		Title1    string `json:"title1"`
-		Library []struct {
-			Title 			 string `json:"title"`
-			Key              string `json:"key"`
-			Location         []struct {
+		Library   []struct {
+			Title    string `json:"title"`
+			Key      string `json:"key"`
+			Location []struct {
 				ID   int    `json:"id"`
 				Path string `json:"path"`
 			} `json:"Location"`
@@ -50,27 +50,27 @@ type PlexSearch struct {
 		SearchResult []struct {
 			Score    float64 `json:"score"`
 			Metadata struct {
-				LibrarySectionTitle  string `json:"librarySectionTitle"`
-				RatingKey			 string `json:"ratingKey"`
-				Key                  string `json:"key"`
-				Type                 string `json:"type"`
-				Title                string `json:"title"` // Track
-				GrandparentTitle     string `json:"grandparentTitle"` // Artist
-				ParentTitle          string `json:"parentTitle"` // Album
-				OriginalTitle        string `json:"originalTitle"`
-				Summary              string `json:"summary"`
-				Duration             int    `json:"duration"`
-				AddedAt              int    `json:"addedAt"`
-				UpdatedAt            int    `json:"updatedAt"`
-				Media                []struct {
-					ID            int    `json:"id"`
-					Duration      int    `json:"duration"`
-					Part          []struct {
-						ID        int    `json:"id"`
-						Key       string `json:"key"`
-						Duration  int    `json:"duration"`
-						File      string `json:"file"`
-						Size      int    `json:"size"`
+				LibrarySectionTitle string `json:"librarySectionTitle"`
+				RatingKey           string `json:"ratingKey"`
+				Key                 string `json:"key"`
+				Type                string `json:"type"`
+				Title               string `json:"title"`            // Track
+				GrandparentTitle    string `json:"grandparentTitle"` // Artist
+				ParentTitle         string `json:"parentTitle"`      // Album
+				OriginalTitle       string `json:"originalTitle"`
+				Summary             string `json:"summary"`
+				Duration            int    `json:"duration"`
+				AddedAt             int    `json:"addedAt"`
+				UpdatedAt           int    `json:"updatedAt"`
+				Media               []struct {
+					ID       int `json:"id"`
+					Duration int `json:"duration"`
+					Part     []struct {
+						ID       int    `json:"id"`
+						Key      string `json:"key"`
+						Duration int    `json:"duration"`
+						File     string `json:"file"`
+						Size     int    `json:"size"`
 					} `json:"Part"`
 					AudioChannels int    `json:"audioChannels"`
 					AudioCodec    string `json:"audioCodec"`
@@ -81,7 +81,6 @@ type PlexSearch struct {
 	} `json:"MediaContainer"`
 }
 
-
 type PlexServer struct {
 	MediaContainer struct {
 		Size              int    `json:"size"`
@@ -112,15 +111,15 @@ type PlexPlaylist struct {
 }
 
 type Plex struct {
-	machineID string
-	LibraryID string
+	machineID  string
+	LibraryID  string
 	HttpClient *util.HttpClient
-	Cfg config.ClientConfig
+	Cfg        config.ClientConfig
 }
 
 func NewPlex(cfg config.ClientConfig, httpClient *util.HttpClient) *Plex {
 	return &Plex{
-		Cfg: cfg,
+		Cfg:        cfg,
 		HttpClient: httpClient}
 }
 
@@ -135,7 +134,7 @@ func (c *Plex) AddHeader() error {
 		c.Cfg.Creds.Headers["X-Plex-Token"] = c.Cfg.Creds.APIKey
 		if err := c.getServer(); err != nil {
 			return err
-	}
+		}
 		return nil
 	}
 	return fmt.Errorf("couldn't get API key")
@@ -154,7 +153,6 @@ func (c *Plex) GetAuth() error { // Get user token from plex
 		return fmt.Errorf("failed to marshal payload: %s", err.Error())
 	}
 
-
 	body, err := c.HttpClient.MakeRequest("POST", "https://plex.tv/users/sign_in.json", bytes.NewBuffer(payloadBytes), c.Cfg.Creds.Headers)
 	if err != nil {
 		return fmt.Errorf("%s", err.Error())
@@ -236,7 +234,7 @@ func (c *Plex) SearchSongs(tracks []*models.Track) error {
 			slog.Warn("search request failed for '%s': %s", track.Title, err.Error())
 			continue
 		}
-		
+
 		var searchResults PlexSearch
 		if err = util.ParseResp(body, &searchResults); err != nil {
 			slog.Warn("failed to parse response for '%s': %s", track.Title, err.Error())
@@ -277,7 +275,6 @@ func (c *Plex) SearchPlaylist() error {
 	return nil
 }
 
-
 func (c *Plex) CreatePlaylist(tracks []*models.Track) error {
 	params := fmt.Sprintf("/playlists?title=%s&type=audio&smart=0&uri=server://%s/com.plexapp.plugins.library/%s", c.Cfg.PlaylistName, c.machineID, c.LibraryID)
 
@@ -302,7 +299,7 @@ func (c *Plex) CreatePlaylist(tracks []*models.Track) error {
 func (c *Plex) UpdatePlaylist() error {
 	params := fmt.Sprintf("/playlists/%s?summary=%s", c.Cfg.PlaylistID, url.QueryEscape(c.Cfg.PlaylistDescr))
 
-	if _, err := c.HttpClient.MakeRequest("PUT",c.Cfg.URL+params, nil, c.Cfg.Creds.Headers); err != nil {
+	if _, err := c.HttpClient.MakeRequest("PUT", c.Cfg.URL+params, nil, c.Cfg.Creds.Headers); err != nil {
 		return err
 	}
 	return nil
@@ -358,7 +355,7 @@ func getPlexSong(track *models.Track, searchResults PlexSearch) (string, error)
 
 		media := md.Media[0]
 		pathMatch := strings.Contains(strings.ToLower(media.Part[0].File), strings.ToLower(track.File))
-		durationMatch := util.Abs(media.Duration - track.Duration) < 10000 // duration within 10s
+		durationMatch := util.Abs(media.Duration-track.Duration) < 10000 // duration within 10s
 
 		if durationMatch && pathMatch {
 			slog.Debug(fmt.Sprintf("matched track via path: %s by %s", track.Title, track.Artist))
@@ -380,4 +377,4 @@ func (c *Plex) addtoPlaylist(tracks []*models.Track) {
 			}
 		}
 	}
-}
+}