News • Examples • Documentation • Download • Buy • Forum • Contact

krpano Testing Server Version 1.24

The krpano Testing Server is a small and easy-to-use static file web server for localhost development. It is a single-file application with no installation or setup required. It allows running local web content without browser file access restrictions. The server can be accessed on the local system, within the local network and via port forwarding from the internet. It also provides a mobile-friendly Directory Listing, cache control for fast content updates and includes a fully featured Code Editor for editing files locally or remotely.
There are two versions of the krpano Testing Server available:

krpano Testing Server (GUI version) Windows, macOS

Downloads
krpano-Testing-Server.zip (Intel 64bit)
krpano-Testing-Server-ARM64.zip (ARM 64bit)
krpano-Testing-Server-Intel.dmg (Intel 64bit)
krpano-Testing-Server-AppleSilicon.dmg (ARM 64bit)
krpano-Testing-Server.AppImage (Intel 64bit)
krpano-Testing-Server-ARM64.AppImage (ARM 64bit)

Note: also included in the krpano download package.
Application Settings:
  • Local Folder
    • Sets the server root folder.
    • All files and subfolders inside this folder are accessible via the web server.
  • Interface
    • Lists all available IP addresses of this computer.
    • Select which interface the server should bind to.
  • Port
    • The network port used by the server (must be unique).
    • Enable "Auto" to use a random free port.
  • HTTPS
    • Enable HTTPS support.
    • HTTPS encrypts data transfer between the server and the browser.
    • Required for many Web APIs, including WebXR, geolocation, camera/microphone access, service workers and SharedArrayBuffer.
    • By default, an automatically generated self-signed certificate is used.
    • When enabling "Custom Certificate", a custom certificate file can be selected.
    • Note: The default HTTPS certificate is self-signed and not trusted by browsers. A warning page will be shown on first access and needs to be manually accepted.
  • Send No-Cache Headers
    • Sends no-cache headers to force the browser to reload files.
  • No-Cache only for Text Files
    • Limits no-cache headers to text-based files only.
  • Send CORS Headers
    • Adds CORS headers to allow cross-origin access.
    • Security Warning: Enabling CORS allows other websites to access your server resources! Only enable this if required!
  • Send COIsolated Headers
  • Edit Mode
    • Enables file editing.
    • Text files can be opened in the integrated Code Editor.
    • Modifying files is possible (only via the code editor).
    • Security Warning: When allowing direct access from the internet (e.g. via port forwarding), HTTP authentication should be enabled to protect access!
  • Limit Download Speed
    • Limits the download speed of the server.

krpano Testing Server (Command-Line version) Windows, macOS

Download CLI Version
krpano-Testing-Server-CLI-Windows.zip (Intel 64bit)
krpano-Testing-Server-CLI-Windows-ARM64.zip (ARM 64bit)
krpano-Testing-Server-CLI-macOS-Intel.zip (Intel)
krpano-Testing-Server-CLI-macOS-AppleSilicon.zip (Apple Silicon)
krpano-Testing-Server-CLI-macOS-Universal.zip (Universal Binary)
krpano-Testing-Server-CLI-Linux.zip (Intel 64bit)
krpano-Testing-Server-CLI-Linux-ARM64.zip (ARM 64bit)

Note: also included in the krpano download package.
The Command-Line version offers nearly the same functionality as the GUI version, except for logging and the built-in code editor. It is smaller, unbranded and better suited for deployment.

Command-Line parameters:
  • -root=###
    • Sets the server root folder.
    • All files and subfolders inside this folder are accessible via the web server.
    • By default, the current working directory is used.
  • -url=###
    • Specifies the URL path (relative to the root folder) to open automatically in the browser on startup.
    • By default, the root folder is opened.
    • If a folder contains index.html, tour.html, or krpano.html, one of these files will be opened automatically.
  • -interface=#
    • Selects the network interface (IP address) to bind to.
    • Use -interface=list to list all available interfaces.
  • -port=###
    • Sets the network port.
    • By default, a random free port is used.
  • -cors=###
    • Enables or disables CORS headers to allow cross-origin access.
    • Settings: true (default) or false.
  • -coisolated
  • -nocache=###
    • Controls HTTP caching behavior.
    • Settings:
      • default – disables caching for text-based files (HTML, XML, JS, ...).
      • all – disables caching for all files.
      • off – no explicit cache control.
  • -open=###
    • Defines what to open on startup.
    • Settings:
      • default – opens the server URL in the default browser.
      • no – does not open anything.
      • path to app – runs the given application with the server URL as parameter.
  • -s
    • Enables HTTPS using an automatically generated self-signed certificate.
  • -cert=###
    • Enables HTTPS using a custom certificate file (path to a .pem file).
  • -q
    • Quiet mode (no console output).

HTTP Authentication:
  • -makepass .htpasswd user password
    • Generates a .htpasswd file for HTTP authentication.
    • Place the .htpasswd file in the folder that should be protected. Access to this folder (and its subfolders) will then require authentication.
    • Example: To protect the entire server, place the .htpasswd file in the root directory.
    • Security Warning: When allowing direct access from the internet (e.g. via port forwarding), always use authentication to protect access!

Directory Listing

The krpano Testing Server provides a CSS-styled directory listing for easy browsing of files and folders. To customize the directory listing, place a file named krpanotestingserver.css in the server root folder.

krpano Code Editor

The krpano Code Editor is a fully featured, browser-based code editor based on CodeMirror and optimized for remote and mobile editing. It allows editing files directly on your system, across your local network, or remotely via port forwarding.
Features:
  • Editing & Access
    • Edit files directly in the browser.
    • Works locally, across the network, or remotely.
    • Built-in file explorer with file management and file dialogs.
  • Mobile & Touch Support
    • Optimized for touch devices and mobile workflows.
    • Virtual keyboard for coding (Tab and cursor keys, customizable layout and size)
    • Edit bar for common actions such as copy, paste and search.
    • Direct cursor positioning.
    • Touch selection handles.
    • Pinch-to-zoom support.
    • Custom touch scrollbars.
  • Code Editing Features
    • Syntax highlighting for many file types, including krpano XML files.
    • Autocompletion.
    • Automatic link, number and color selection on double-click/double-tap.
    • Syntax-aware block selection.
    • Standard editing tools such as copy, paste, select, search and replace.
    • Split view.
    • Undo / Redo.
    • Recent files switcher (Ctrl/Cmd + the key above the tab key).
    • Keyboard shortcuts.
  • Appearance & Customization
    • Quick accessible preferences and options.
    • Many built-in themes, including light and dark themes.
    • Advanced theme customization with color post-processing filters.
    • Custom fonts.
  • Color Tools
    • Built-in powerful color dialog / color picker.
    • OKLCH color mixing, with optional RGB, HSL and temperature/tint modes.
    • Gamut management.
    • Contrast checking.
    • CSS color formatting.
  • Tools & Utilities
    • Case conversion.
    • Base64, Hex conversion.
    • Tabs ↔ Spaces conversion.
    • Quote conversion.
    • Code beautifying / formatting.
    • Codepage conversion.

Online-Tests / Examples Note - without the krpano Testing Server backend, there is no file-system available!

* Port Forwarding

Port forwarding allows remote access to the local server from the internet. It works by forwarding a port on your router to the computer running the krpano Testing Server. This allows accessing the server remotely, for example from mobile devices outside your local network.

The exact setup depends on your router and network configuration.

Security Warning: Exposing the server to the internet may allow unauthorized access.
Always use HTTPS and HTTP authentication when enabling port forwarding!