X-Git-Url: https://git.r.bdr.sh/rbdr/mobius/blobdiff_plain/6988a0571d5d37ea0f38ee3e4066533158f608bc..165b7ac9486067e349fc8cc71f1d10851c8db40e:/README.md diff --git a/README.md b/README.md index 799a903..9597ca3 100644 --- a/README.md +++ b/README.md @@ -1,83 +1,68 @@ # Mobius -Cross-platform command line [Hotline](https://en.wikipedia.org/wiki/Hotline_Communications) server and client +Mobius is a cross-platform command line [Hotline](https://en.wikipedia.org/wiki/Hotline_Communications) server, client, and library developed in Golang. -[![CircleCI](https://circleci.com/gh/jhalter/mobius/tree/master.svg?style=svg&circle-token=7123999e4511cf3eb93d76de98b614a803207bea)](https://circleci.com/gh/jhalter/mobius/tree/master) +The project aims to support Hotline functionality from versions v1.2.3 and >v1.5 (e.g. threaded news and folder transfers). -# Installation +## Project status -### Mac OS X +### Server -#### Client +* Near feature complete - brew install jhalter/mobius-hotline-client/mobius-hotline-client +### Client -#### Server +* Early stage with functionality for chat and news posting only - brew install jhalter/mobius-hotline-client/mobius-hotline-client +# Getting started -### Linux +### Mac OS -Download a compiled release for your architecture from the Releases page +For Mac OS the easiest path to installation is to install through Homebrew. -### Windows +#### Client - TODO + brew install jhalter/mobius-hotline-client/mobius-hotline-client -# Build +After installation `mobius-hotline-client` installed to `/usr/local/bin/mobius-hotline-client` and should be in your $PATH. -To build from source, run -`make build` +The client config file is in `/usr/local/etc/mobius-client-config.yaml` -# Features +Run `mobius-hotline-client -help` for usage options. -* Hotline 1.2.3 +#### Server -## Usage + brew install jhalter/mobius-hotline-server/mobius-hotline-server -### Precompiled binaries -To get started quickly, download the precompiled binaries for your platform: +After installation `mobius-hotline-server` installed to `/usr/local/bin/mobius-hotline-server` and should be in your $PATH. -* [Linux]() -* [Mac OS X]() +The server config file directory is under `/usr/local/var/mobius` which by default contains: -## Compatibility + /usr/local/var/mobius/config/MessageBoard.txt + /usr/local/var/mobius/config/config.yaml + /usr/local/var/mobius/config/ThreadedNews.yaml + /usr/local/var/mobius/config/Agreement.txt + /usr/local/var/mobius/config/Users/guest.yaml + /usr/local/var/mobius/config/Users/admin.yaml -The server has been tested with: - * Hotline Client version 1.2.3 - * Hotline Client version 1.8.2 - * Hotline Client version 1.9.2 - * Nostalgia +Edit `/usr/local/var/mobius/config/config.yaml` to change your server name and other settings. -### Build from source +Edit `/usr/local/var/mobius/config/Agreement.txt` to set your server agreement. - make build +Run `mobius-hotline-server -help` for usage options. +### Linux -# TODO +Download a compiled release for your architecture from the Releases page -* Implement 1.5+ protocol account editing -* Implement folder transfer resume -* Implement file transfer queuing -* Map additional file extensions to file type and creator codes -* Implement file comment read/write -* Implement user banning -* Implement Maximum Simultaneous Downloads -* Maximum simultaneous downloads/client -* Maximum simultaneous connections/IP -* Implement server broadcast -* Implement statistics: - * Currently Connected - * Downloads in progress - * Uploads in progress - * Waiting Downloads - * Connection Peak - * Connection Counter - * Download Counter - * Upload Counter - * Since +### Windows + TODO + + +### Build from source -# TODO - Someday Maybe +To build from source, run: -* Implement Pitbull protocol extensions \ No newline at end of file + make build-client + make build-server