Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Zaxonomy/mars-base-10

This is the urbit console you have been waiting for
https://github.com/Zaxonomy/mars-base-10

Last synced: about 1 month ago
JSON representation

This is the urbit console you have been waiting for

Awesome Lists containing this project

README

        

# Mars::Base::10

This is the urbit console you have been waiting for

## Installation

Add this line to your application's Gemfile:

```ruby
gem 'mars_base_10'
```

And then execute:

$ bundle install

Or install it yourself as:

$ gem install mars_base_10

## Usage

```
$ mb10 --help
__ __ ____ _ ___
| \/ | __ _ _ __ ___ | __ ) __ _ ___ ___ / | / _ \
| |\/| | / _` | | '__| / __| | _ \ / _` | / __| / _ \ | | | | | |
| | | | | (_| | | | \__ \ | |_) | | (_| | \__ \ | __/ | | | |_| |
|_| |_| \__,_| |_| |___/ |____/ \__,_| |___/ \___| |_| \___/

Commands:
mb10 help, --help, -h # Describe available commands or one specific command
mb10 launch [SHIP_CONFIG] # Start Mars Base 10 connected to the Urbit ship defined in SHIP_CONFIG. (Required)
mb10 version, --version, -v # print the version number, then exit

Options:
[--no-color] # Disable colorization in output
```
### Basic Usage and Navigation

#### Group Explorer

When you initially open the app you will see the Group Explorer with the group list pane highlighted in red:

![Group Explorer](screenshots/group-list-pane.png)

Properties of the group are displayed below in the Group details pane.

From here you can choose a group by moving up (k) and down (j) using vim-style motion or jump immediately by typing the row number (04).
The channel list pane will change automatically as you change the group.

Use "Inspect" (i) to select a group and move the focus to the channel list pane.

![Channel List](screenshots/channel-list-pane.png)

Properties of the channel are displayed below in the Channel details pane.

#### Social Lounge (Chat Reader)

Use "Read" (r) to read the latest messages of the currently selected channel.

**NOTE**: This is currently slow and will take a couple of seconds to pop up. There is no caching or performance improvements of any kind yet. Furthermore, quite a bit of the parsing logic is still here in mb10 when it should be in the airlock itself. Expect this to improve in the future.

![Channel List](screenshots/channel-reader-pane.png)

#### Graph Explorer

![Graph Explorer](screenshots/graph-list-pane.png)

From here you can choose a graph by moving up (k) and down (j) using vim-style motion or jump immediately by typing the row number (04). The node list pane will change automatically as you change the graph. Use "Inspect" (i) to select a graph and move the focus to the node list pane.

![Node Explorer](screenshots/node-list-pane.png)

If, as shown in the picture, the node you as inspecting has children, you can "Dive" (d) into those children and look at them.

![Graph Explorer](screenshots/node-list-pane-dive.png)

Use "Pop" (p) to return to the parent node. You can return focus to the graph list pane by pressing (g).

#### Changing your view

By pressing "Switch App" (X) you will swap between the Social Lounge (Reader), the Graph Explorer, and the Group Explorer.

## Contributing

Bug reports are welcome on GitHub at https://github.com/Zaxonomy/mars-base-10.

This is 100% alpha code and a work in progress. It is not ready yet for contributions, but I would love any constructive feedback.

## License

The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).