Aphorio

Like Windows Task Manager, but also works on Linux and displays web servers, docker containers, and more.

• Web Servers
  • Serves and proxies HTTP over WebSockets for both TCP and TLS
  • Server standup via small JSON configuration, which includes optional proxies and traffic redirection
  • Simple and yet more powerful file system navigation via web server
  • Servers include a temporary option to spin up servers with no state information
• Docker Compose container management
• OS Data dashboards:
  • Accounts for system and users
  • Network interfaces
  • Network sockets and ports
  • OS and hardware information
  • OS services
  • Processes
  • Storage hardware and partition data
• Provides remote shell access, via browser based dashboard, for a variety of shells executing on the server
• Graphical file system navigation for the server
• Network testing tools:
  • Forward and reverse DNS lookup for up to 11 record types
  • HTTP request tester with complete raw payload inspection for both requests and responses
  • WebSocket tester with raw frame header inspection/editing
  • Hash and Base64 tool

Determine which features to exclude by simply setting a boolean value in the features.json file.

• https://prettydiff.github.io/aphorio/screenshots/index.html

1. Install Node.js version 24 or later.
2. Install git
3. Execute git clone https://github.com/prettydiff/aphorio.git
4. Execute cd aphorio
5. Run the application: npm run server.
6. Access the dashboard in a browser on the specified random port.

The following benchmarks are executed from the application's internal Performance Test section. The results are hardware specific executed using a localhost address and message size of 120 bytes across multiple experiments each comprising 10 tests.

• 3,250,000 messages in 0.002-0.006 seconds: WebSockets, send only, not including garbage collection of system memory
• 3,250,000 messages in about 1 second: WebSockets, send only, includes memory garbage collection in the tests
• 45,000 messages in about 1 second: WebSockets, full round trip, includes memory garbage collection in the tests
• 100 messages in about 1 second: HTTP GET without keep alive, full round trip, includes memory garbage collection in the tests

• npm run lint - Executes ESLint for TypeScript to analyze the application against a bunch of draconian rules
• npm run server or node ./lib/index.ts - Executes the application
• npm run test or node ./lib/index.ts test - Runs the test automation
• npm run tsc - Executes the TypeScript compiler to perform explicit type checking

Please note that for Docker support the npm run server command must be executed using an administrative account and/or shell.

All arguments are supported only on the server command, example: npm run server test no-color

• browser:<file_path> - Provides for an absolute file path for a web browser executable to test against. The file path value can be quoted, but if not quoted then spaces must be escaped according to the given shell's syntax rules. Any arguments following this argument will be passed directly to that web browser.
• delay-intervals:<number> - A delay test will halt the test runner until the given test evaluates to true by default. The default delay values retry the test 250 times every 50 milliseconds before returning a failed test. This argument allows changing the number of retries.
• delay-time:<number> - Specifies the time between delay intervals in milliseconds from the default 50 milliseconds.
• list:<file_name> - Specifies a single test list file name to execute starting from the project's test directory at /lib/test.
• no-exit - Application remains actively available after completing test automation.
• stop-on-fail - Tells the test runner to stop processing further test lists after the first failed assertion.
• test - If present this option instructs the application to execute test automation.

• no-color - Eliminates use of ANSI color codes in terminal output.
• port-open:<port_number> - Creates an insecure instance of the dashboard server on the specified insecure port, if that port is open.
• port-secure:<port_number> - Creates a secure instance of the dashboard server on the specified insecure port, if that port is open.

Example: npm run test "browser:C:\Program Files\Mozilla Firefox\firefox.exe" "list:list_local_browser_fileSystem.ts" no-exit no-color

• Debian Linux 13
• Windows 11

The external dependencies need to be installed and added to the system path, but require no further configuration. The included dependencies require no action or configuration at all.

These dependencies must be installed separate from this application.

• Node.js
  • License - MIT
  • Description - a command line JavaScript/TypeScript code interpreter and runtime.
  • This application requires version 24.2.0 or greater.
• OpenSSL 3
  • License - Apache
  • Description - a library for certificate generation, encryption, hashing, and other cryptography
  • Installation
    • Windows - winget install --id=ShiningLight.OpenSSL.Dev -e
    • Linux (Debian) - sudo apt install openssl
• Docker and Docker Compose (Optional for Docker support)
  • License - Apache
  • Description - Docker allows execution of application containers and Docker Compose provides configuration with a simple text format
  • Installation
    • Windows

    winget install --id=Docker.DockerCLI -e
    winget install --id=Docker.DockerCompose -e
    

    • Linux (Debian)

    sudo apt-get update
    sudo apt-get install ca-certificates curl
    sudo install -m 0755 -d /etc/apt/keyrings
    sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
    sudo chmod a+r /etc/apt/keyrings/docker.asc
    echo "deb \
        [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
        https://download.docker.com/linux/debian \
        $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
        sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
    sudo apt-get update
    sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
    

These dependencies are included with this application code repository.

• @lydell/node-pty
  • GitHub"
  • License - MIT
  • Description - the binaries powering XTERM emulation for the UI terminal
• @xterm/xterm
  • GitHub
  • License - MIT
  • Description - the actual browser code for the UI terminal
• chart.js
  • GitHub
  • License - MIT
  • Description - the library that creates the statistics charts
• @kurkle/color, dependency of Chart.js
  • GitHub
  • License - MIT
  • Description - a dependency of charts.js library
• file for win32
  • License - BSD 2-2clause
  • Description - allows execution of the Unix file utility on Windows
• jschardet
  • GitHub
  • License - GPLv2.1
  • Description - a fall back to discover text encoding of files