Euporie Console

Euporie console is a terminal frontend for Jupyter kernels, allowing code to be executed interactively and rich output to be displayed.


Euporie console makes use of terminal graphics capabilities to display images, and will render markdown, LaTeX, and ipywidgets.

The command palette can be summoned with Ctrl+Space, which provides access to settings and various operations from within the console.

User Guide

Multi-line editing

The console will check the current input for completeness when the cursor is at the end of the input and Enter is pressed. If the input is determined to be incomplete, a new line will be inserted. Otherwise, the input will be executed.

If two blank lines are entered at the end of the input, the input will be executed.

A new-line can be inserted without checking the input for completeness using Shift+Enter.

The input can be executed immediately using Ctrl+Enter (providing your terminal suports this key-binding; you can also use Ctrl+e).

Save console session as a notebook

Running the save-as command from the command palette will prompt you to save the input and output history of the current console session as a Jupyter notebook file.

Convert console session to a notebook

Running the convert-to-notebook command from the command palette will transform the input and output history of the current console session into a euporie notebook, and open it with Euporie Notebook, reusing the existing kernel connection.

Command Line Interface

Usage

$ euporie-console [-h] [--mouse-support | --no-mouse-support]
                       [--max-stored-outputs int] [--connection-file UPath]
                       [--log-file [str]]
                       [--log-level {debug,info,warning,error,critical}]
                       [--log-config loads]
                       [--clipboard {external,internal,terminal}]
                       [--edit-mode {micro,emacs,vi}] [--tab-size int]
                       [--terminal-polling-interval float]
                       [--formatters loads]
                       [--syntax-highlighting | --no-syntax-highlighting]
                       [--syntax-theme str] [--color-depth {1,4,8,24}]
                       [--color-scheme {default,inverse,light,dark,black,white,custom}]
                       [--custom-background-color str]
                       [--custom-foreground-color str] [--accent-color str]
                       [--custom-styles loads] [--key-bindings loads]
                       [--graphics {none,sixel,kitty,kitty-unicode,iterm}]
                       [--force-graphics | --no-force-graphics]
                       [--enable-language-servers | --lsp | --no-enable-language-servers | --no-lsp]
                       [--language-servers loads]
                       [--set-cursor-shape | --no-set-cursor-shape]
                       [--cursor-blink | --no-cursor-blink]
                       [--backup-on-save | --no-backup-on-save]
                       [--kernel-name str]
                       [--record-cell-timing | --no-record-cell-timing]
                       [--show-remote-inputs | --no-show-remote-inputs]
                       [--show-remote-outputs | --no-show-remote-outputs]
                       [--wrap-cell-outputs | --no-wrap-cell-outputs]
                       [--text-output-limit int]
                       [--show-file-icons | --no-show-file-icons]
                       [--line-numbers | --no-line-numbers]
                       [--autoformat | --no-autoformat]
                       [--autocomplete | --no-autocomplete]
                       [--autosuggest {smart,simple,none}]
                       [--autoinspect | --no-autoinspect]
                       [--show-status-bar | --no-show-status-bar]
                       [--show-shadows | --no-show-shadows]
                       [UPath ...]

Positional Arguments

<UPath> ...

List of file names to open

Optional Arguments

-h, --help

show this help message and exit

--mouse-support, --no-mouse-support

Enable or disable mouse support

--max-stored-outputs <int>

The number of inputs / outputs to store in an in-memory notebook

--connection-file <UPath>, --kernel-connection-file <UPath>

Attempt to connect to an existing kernel using a JSON connection info file

--version, -V

==SUPPRESS==

--log-file <str>

File path for logs

--log-level {debug,info,warning,error,critical}

Set the log level

--log-level-stdout {debug,info,warning,error,critical}

==SUPPRESS==

--log-config <loads>

Additional logging configuration

--clipboard {external,internal,terminal}

The preferred clipboard access method

--edit-mode {micro,emacs,vi}

Key-binding mode for text editing

--tab-size <int>

Spaces per indentation level

--terminal-polling-interval <float>

Time between terminal colour queries

--formatters <loads>

List of external code formatters

--syntax-highlighting, --no-syntax-highlighting

Syntax highlighting

--syntax-theme <str>

Syntax highlighting theme

--color-depth {1,4,8,24}

The color depth to use

--multiplexer-passthrough, --no-multiplexer-passthrough

==SUPPRESS==

--color-scheme {default,inverse,light,dark,black,white,custom}

The color scheme to use

--custom-background-color <str>, --custom-bg-color <str>, --bg <str>

Background color for “Custom” color theme

--custom-foreground-color <str>, --custom-fg-color <str>, --fg <str>

Foreground color for “Custom” color theme

--accent-color <str>

Accent color to use in the app

--custom-styles <loads>

Additional style settings

--key-bindings <loads>

Additional key binding definitions

--graphics {none,sixel,kitty,kitty-unicode,iterm}

The preferred graphics protocol

--force-graphics, --no-force-graphics

Force use of specified graphics protocol

--enable-language-servers, --lsp, --no-enable-language-servers, --no-lsp

Enable language server support

--language-servers <loads>

Language server configurations

--set-cursor-shape, --no-set-cursor-shape

Whether to set the shape of the cursor depending on the editing mode

Whether to blink the cursor

--backup-on-save, --no-backup-on-save

Create backups before saving files

--kernel-name <str>, --kernel <str>

The name of the kernel to start by default

--record-cell-timing, --no-record-cell-timing

Should timing data be recorded in cell metadata.

--show-remote-inputs, --no-show-remote-inputs

Display inputs sent to the kernel by other clients

--show-remote-outputs, --no-show-remote-outputs

Display kernel outputs triggered by other clients

--wrap-cell-outputs, --no-wrap-cell-outputs

Wrap cell output text.

--text-output-limit <int>

Limit the amount of cell text output

--show-file-icons, --no-show-file-icons

Show file icons in the file manager

--line-numbers, --no-line-numbers

Show or hide line numbers

--autoformat, --no-autoformat

Automatically re-format code cells when run

--autocomplete, --no-autocomplete

Provide completions suggestions automatically

--autosuggest {smart,simple,none}

Provide line completion suggestions

--autoinspect, --no-autoinspect

Display contextual help automatically

--show-status-bar, --no-show-status-bar

Show the status bar

--show-shadows, --no-show-shadows

Show or hide shadows under menus and dialogs

Available Commands