1. NovaShell
  2. Installation Instructions
  3. Flags
  4. Keyboard Shortcuts
  5. NSH Specific Commands
  6. Color Customization
  7. Aliases

> NSH: A Modern Shell for UniVerse and D3

Autocomplete! Colors! History! Search! Suggestions!

Suggestions

NovaShell will suggest commands based on what you ran before. Nothing is original.

Arrow Keys

Use intuitive arrow keys to navigate your infinite history. If only life was this easy.

Helpful Prompt

Now you know who you are and where you are. How you are is something NSH can't help with.

Persistent History

Keep all of the commands that you will ever run. Who said hoarding was bad?

Easy Searching

Simply type a random part of a command that you ran years ago and hit the up arrow key.

Auto Completion

Use tab to autocomplete commands. Only remember the first 3 characters from now on!

Colors and suggestions are only supported on xterm.
Use a terminal emulator that allows xterm. Putty on Windows is perfect.
wIntegrate will also work with the term type set to ansi. Make sure to do TERM xterm-256color at TCL before running NSH.




Installation Instructions

On UniVerse and D3 10.3 onwards, it really is the simplest thing!

At the OS terminal:
$ git clone git@github.com:Krowemoh/NovaShell.git
$ cd NovaShell
$ cp NSH /path/to/BP/NSH
In UniVerse/D3:
> BASIC BP NSH
> CATALOG BP NSH
> NSH

Less than a minute to get started with NSH!

For other versions of D3 or if you want to hack on NSH, then please visit the github page.

https://github.com/Krowemoh/NovaShell



Flags

--SHOW-IP - Show the IP address.




Keyboard Shortcuts

Ctrl + A - Clear the command.

Ctrl + F - Complete the suggested command.

Left/Right - Move the cursor in the command for inserting and deleting.

Tab - Get a list of suggestions for a command.

Up/Down - Navigate the commands in your history.




NSH Specific Commands

.{A/C/D/L/R/U/X}#

Dot commands have all been re-implemented.
You can execute multilple commands by doing .X2,5

!

Run operating system commands using the bang.

CLEAR/CLS

Clear the screen.

DATECONV

Convert dates from internal to external format and vice versa.

EXIT

Quit NSH.

HISTORY

Display the entire history to the screen.

MAN {WORD}

Access the system help in a way familiar only to nerds.

MAN BASIC {WORD}

Access the BASIC help in a way familiar only to nerds.

NSHUP {ENABLE/DISABLE} STARTUP

The command to manage NSH running on startup.

NSHUP {CHECK/UPDATE}

The command to check for or update to a newer version of NSH.

PRINT OCONV({CONV},{VAL})

Quickly test out OCONVs without having to look them up!

Q

Quit NSH.

SEARCH {FILE} {SEARCH.STRING}

A single line search.

TCL

Quit NSH and enter TCL.

TIMECONV

Convert times from internal to external format.

VERSION

Show the NSH version.

WATCH {FILE} {RECORD}[,{FILE} {RECORD]

Watch a set of files and recompile them on every change. This command is experimental.




Color Customization

To customize the colors of NSH, you'll need to create a profile file and then specify your colors.

Create a {username}.nsh_profile in the NSH-HISTORY-FILE. The username will be whatever the prompt displays as the username, this is case sensitive.

The first attribute of this file specifies the colors.

The order is:

  1. PROMPT.COLOR
  2. FOREGROUND.COLOR
  3. INPUT.COLOR
  4. ERROR.COLOR
  5. USER.COLOR
  6. PORT.COLOR
  7. AT.COLOR
  8. ACCOUNT.COLOR
  9. SUGGESTION.COLOR
  10. BACKGROUND.COLOR

The first attribute should be a multivalued list of ANSI escape codes.

Blanks will be left as the default color.

ANSI escape codes follow the pattern of [38;5;{NUM}m. The available numbers are 1-256. This is for the ANSI 256 colors.




Aliases

To add aliases, you'll need to update your nsh_profile file.

The 2nd attribute of this file is the list of keywords you want to use as your aliases.

The 3rd attribute is the commands to run.