[Draft] feat: browser-side zip grouping for uploads (AI-generated, unreviewed)

.env.dist

@@ -26,6 +26,8 @@ TZ=UTC
 #GOKAPI_MAX_FILESIZE=102400
 #GOKAPI_MAX_MEMORY_UPLOAD=50
 #GOKAPI_MAX_PARALLEL_UPLOADS=3
+# Default name template for browser-side zip archives (supports date tokens like %Y %m %d %H %M %S)
+#GOKAPI_DEFAULT_ZIP_NAME=gokapi-upload-%Y%m%d-%H%M%S
 #TMPDIR=/app/data/tmp
 
 

docs/advanced.rst

@@ -82,6 +82,12 @@ Available environment variables
 +-------------------------------------+----------------------------------------------------------------------------------------+-----------------+-----------------------------+
 | GOKAPI_DATA_DIR                     | Sets the directory for the data                                                        | Yes             | data                        |
 +-------------------------------------+----------------------------------------------------------------------------------------+-----------------+-----------------------------+
+| GOKAPI_DEFAULT_ZIP_NAME             | Sets the default name template used when compressing an upload into a zip              | No              | gokapi-upload-%Y%m%d-%H%M%S |
+|                                     |                                                                                        |                 |                             |
+|                                     | archive in the browser. Supports strftime-style date tokens, e.g.                      |                 |                             |
+|                                     |                                                                                        |                 |                             |
+|                                     | %Y %m %d %H %M %S. The .zip extension is added automatically.                          |                 |                             |
++-------------------------------------+----------------------------------------------------------------------------------------+-----------------+-----------------------------+
 | GOKAPI_DISABLE_API_MENU             | Disables the API menu and generation of API keys for non-admin users                   | No              | false                       |
 +-------------------------------------+----------------------------------------------------------------------------------------+-----------------+-----------------------------+
 | GOKAPI_DISABLE_CORS_CHECK           | Disables the CORS check on startup and during setup, if set to true                    | No              | false                       |

internal/environment/Environment.go

@@ -77,6 +77,10 @@ type Environment struct {
 	UseCloudFlare bool `env:"USE_CLOUDFLARE" envDefault:"false"`
 	// Sets the webserver port
 	WebserverPort int `env:"PORT" envDefault:"53842" onlyPositive:"true" persistent:"true"`
+	// Sets the default name template used when compressing an upload into a zip
+	// archive in the browser. Supports strftime-style date tokens, e.g.
+	// %Y %m %d %H %M %S. The .zip extension is added automatically.
+	DefaultZipName string `env:"DEFAULT_ZIP_NAME" envDefault:"gokapi-upload-%Y%m%d-%H%M%S"`
 	// Allow hotlinking of videos. Note: Due to buffering, playing a video might count as
 	// multiple downloads. It is only recommended to use video hotlinking for uploads with
 	// unlimited downloads enabled

internal/webserver/Webserver.go

@@ -761,6 +761,7 @@ type AdminView struct {
 	IsUserTabAvailable    bool
 	EndToEndEncryption    bool
 	IncludeFilename       bool
+	DefaultZipName        string
 	IsInternalAuth        bool
 	ShowApiMenu           bool
 	ShowDeprecationNotice bool
@@ -912,6 +913,7 @@ func (u *AdminView) convertGlobalConfig(view int, user models.User) *AdminView {
 	u.MaxParallelUploads = config.MaxParallelUploads
 	u.ChunkSize = config.ChunkSize
 	u.IncludeFilename = config.IncludeFilename
+	u.DefaultZipName = configuration.GetEnvironment().DefaultZipName
 	return u
 }
 

internal/webserver/web/static/css/cover.css

@@ -834,6 +834,17 @@ tr.no-bottom-border td {
     filter: invert(1) brightness(0.6);
 }
 
+/* ── Zip archive name template input ────────────────────────────── */
+
+.upload-option-zip-input {
+    font-size: 0.8rem;
+}
+
+.upload-option-zip-input::placeholder {
+    color: #6c757d;
+    opacity: 1;
+}
+
 
 .modal-samesize-input-edit {
    width: 11rem;

internal/webserver/web/static/js/admin_ui_upload.js

@@ -23,6 +23,12 @@ function initDropzone() {
         init: function() {
             dropzoneObject = this;
             this.on("addedfile", file => {
+                // If zip grouping is enabled, buffer the file and compress a batch
+                // into a single archive instead of uploading files individually.
+                // handleZipAddedFile() returns true if it took ownership of the file.
+                if (typeof handleZipAddedFile === "function" && handleZipAddedFile(file)) {
+                    return;
+                }
                 file.upload.uuid = getUuid();
                 saveUploadDefaults();
                 addFileProgress(file);