Skip to content

cognetwork-dev/Metallic

Repository files navigation

Metallic

A powerful web proxy built for speed and customization.

Access the web with this stylish web proxy made in Preact supporting many sites. Metallic was originally created for TN's proxathon where it won 2nd place!

Features

  • Modern and clean design
  • Support for many popular sites
  • Customizable interface
  • Mobile support
  • Expansive library of themes
  • Large selection of games thanks to Radon Games!

Setup

Tip

Run npm install to install the required dependencies.

Run

Run npm start to start the server. If no build folder if found, Metallic will attempt to build.

Build

Run npm run build to build app for production into the build folder.

Development

Run npm run dev to run the app in development mode. Rammerhead will not work in dev mode.

Configuration

Themes

Themes can be configured from the /src/themes.json file. The file should be an array of objects using the format below.

Important

Themes file will be validated before building, starting the server, or the dev server.

{
    "name": "string", # Display name of theme
    "id": "string", # Unique ID of theme
    "theme": {
        "background": "string", # Background color of site
        "secondary": "string", # Buttons and inputs
        "primary": "string", # Icons amd logo
        "text": "string", # Text color
        "textInverse": "string", # Text color for buttons and inputs
        "font": "string" # Font for website (default is "Roboto")
    },
    "custom": { # Optional
        "selector": { # CSS selector (".nav" for example)
            "key": "string" # CSS key and value ("background": "red" for example)
        }
    }
}

Issues

Using older versions of Node.js will cause Metallic to crash. Upgrade to the latest version using nvm install --lts.

Changelog/Roadmap

Check out the changelog and roadmap

License

Metallic uses the MIT license.