Skip to content

ahigerd/galosh

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

149 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Galosh Galosh icon

A cross-platform MUD client.

A screenshot of Galosh in action

Why Galosh?

Galoshes are what you wear when you're going to go out in the mud.

Galosh is inspired by the simplicity of older MUD clients. Mudlet is nice — it's full-featured and well-supported. And Galosh agrees with Mudlet's vision that the more projects are involved in the MUD ecosystem, the better. So if you find 3D map displays, fancy scripts, and the like to be a little too much, Galosh may be right for you.

And maybe you'll find something in Galosh that you like. Galosh's tab completion works a little differently, its automapper keeps track of room descriptions, and it can keep more information about the current room visible at a glance.

Features

  • Cross-platform (Windows, macOS, X11, Wayland)
  • ANSI/VT100/VT102 formatting support with configurable colors
  • Works with Telnet, plain text connections, and local text-based programs
  • SSL/TLS encryption support
  • MSSP protocol support
  • GMCP protocol support
  • Multiple saved profiles
  • Control multiple connected characters
  • Triggers
  • Automapping, automatic pathfinding, and speedwalking
  • Environment and status displays
  • Command history
  • Multi-line command editing
  • Tab completion
  • Mudlet map importing
  • Offline map exploration
  • Searchable item database
  • Quick-equip item sets
  • Smart aliases / custom commands
  • Client command documentation (/HELP)

Roadmap

  • Full documentation
  • Context-aware tab completion (spellcasting, etc.)
  • Trigger variables
  • Conditional triggers
  • Split-screen
  • Prebuilt releases for macOS
  • Unicode support on Windows
  • Better management of server-level profile settings
  • Better accessibility for user interface

Getting Galosh

Windows

Galosh is distributed as a portable app on Windows. Download the latest release of Galosh and extract galosh.exe to any path you like. No installation required!

Build from source

Galosh requires Qt 5.15 or newer, including Qt 6.x.

  • git clone https://github.com/ahigerd/galosh.git
  • Open the galosh folder
  • Optionally, edit galosh.pro to set the CONFIG flags.
    • The official Windows build uses CONFIG += release static and CONFIG -= debug debug_and_release.
  • qmake
  • make

Using Galosh

Quick Start

  1. Launch Galosh. The Profiles dialog will open automatically.
  2. Fill in a profile name, server hostname, and server port number. Check "Use SSL/TLS" if the server supports secure connections.
  3. Optionally, fill in a username, password, and login/password prompts to automatically log in after connecting.
  4. Click Connect.

Documentation

Documentation for Galosh can be found in the doc/ folder.

License

Copyright © 2025 Adam Higerd

Galosh is free software; you can redistribute it and/or modify it under the terms of version 3 of the GNU General Public License as published by the Free Software Foundation. This program is distributed in the hope that it will be useful, but without any warranty, even the implied warranty of merchantability or fitness for a particular purpose. See the full text of the GPLv3 for more information.

Galosh makes use of portions of QTermWidget. QTermWidget is available under the GPLv2 or any later version. Some source files may be available under a different license. See each file in src/qtermwidget for more information.

On Windows, Galosh uses mman-win32, available under the MIT license.

Galosh is built upon Qt. Qt is copyright © The Qt Company Ltd and other contributors and used under the terms of the GNU Lesser General Public License version 3. See Qt's licensing page for more information.

About

Qt-based MUD client

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages