https://github.com/joouha/euporie Skip to content Sign up * Why GitHub? Features - + Mobile - + Actions - + Codespaces - + Packages - + Security - + Code review - + Project management - + Integrations - + GitHub Sponsors - + Customer stories- * Team * Enterprise * Explore + Explore GitHub - Learn and contribute + Topics - + Collections - + Trending - + Learning Lab - + Open source guides - Connect with others + The ReadME Project - + Events - + Community forum - + GitHub Education - + GitHub Stars program - * Marketplace * Pricing Plans - + Compare plans - + Contact Sales - + Education - [ ] [search-key] * # In this repository All GitHub | Jump to | * No suggested jump to results * # In this repository All GitHub | Jump to | * # In this user All GitHub | Jump to | * # In this repository All GitHub | Jump to | Sign in Sign up {{ message }} joouha / euporie * Notifications * Star 1 * Fork 0 Euporie is a text-based user interface for running and editing Jupyter notebooks GPL-3.0 License 1 star 0 forks Star Notifications * Code * Issues 0 * Pull requests 0 * Actions * Projects 0 * Wiki * Security * Insights More * Code * Issues * Pull requests * Actions * Projects * Wiki * Security * Insights main Switch branches/tags [ ] Branches Tags Nothing to show {{ refName }} default View all branches Nothing to show {{ refName }} default View all tags 1 branch 1 tag Code Clone HTTPS GitHub CLI [https://github.com/j] Use Git or checkout with SVN using the web URL. [gh repo clone joouha] Work fast with our official CLI. Learn more. * Open with GitHub Desktop * Download ZIP Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Go back Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Go back Launching Xcode If nothing happens, download Xcode and try again. Go back Launching Visual Studio If nothing happens, download the GitHub extension for Visual Studio and try again. Go back Latest commit @joouha joouha Update readme ... dc6a8f6 May 8, 2021 Update readme dc6a8f6 Git stats * 2 commits Files Permalink Failed to load latest commit information. Type Name Latest commit message Commit time euporie Initial commit May 8, 2021 tests Initial commit May 8, 2021 .flake8 Initial commit May 8, 2021 .gitignore Initial commit May 8, 2021 .pre-commit-config.yaml Initial commit May 8, 2021 LICENSE Initial commit May 8, 2021 README.md Update readme May 8, 2021 poetry.lock Initial commit May 8, 2021 pyproject.toml Initial commit May 8, 2021 View code Euporie About Install Screenshots Features Image Support HTML Support Key Bindings Key Remapping xterm konsole Roadmap Related projects README.md Euporie screenshot 1 About Euporie is a text-based user interface for running and editing Jupyter notebooks. Install Euporie is on pypi, so can be installed using pip: pip install euporie If you are using Windows, you may wish to install some optional python dependencies to render images and HTML tables: pip install euporie[tables,images] Screenshots screenshot 2 screenshot 3 screenshot 4 screenshot 5 screenshot 6 Features * Execute notebooks in the terminal * Autocompletion in code cells * Rich output support, including: + Markdown + Tables + Images * Open multiple notebooks side-by-side * Good performance with large notebook files Image Support Euporie will attempt to render images in the best possible way it can. The following methods are supported: * Sixel If supported by your teminal, euporie can show graphical images in cell outputs This requires one of the following: imagemagik timg teimpy * Kitty's terminal image protocal If your terminal supports kitty's terminal graphics protocol, euporie will use it to render images * Ansi art This requires one of the following: timg catimg icat timg tiv viu img2unicode jp2a img2txt The kitty & sixel image rendering methods will fall back to ansi art images when rendering images in partially obscured cells, to prevent clipped images destroying the user interface. For SVG support, cairosvg or imagemagik are required. HTML Support Euporie will attempt to render HTML outputs. This requires one of the following: w3m elinks lynx links mtable Note: only HTML tables will be displayed if mtable is used If none of these commands are found in your $PATH, the plain text representation will be used. Key Bindings Command Key Binding Quit Ctrl + q Close notebook Ctrl + w Select next cell Up, k Select previous cell Down, j Page up (move up 5 cells) Pgup Page down (move down 5 cells) PgDown Scroll up [ Scroll down ] Enter edit mode Enter Exit edit mode Esc*, Esc, Esc Edit cell in $EDITOR e Run cell Ctrl + Enter**, Ctrl + Space, F20 Run cell and select next cell Shift + Enter**, F21 Insert cell above selected cell a Insert cell below selected cell b Toggle line numbers l Copy cell c Cut cell x Paste cell v Delete cell dd * There is a slight delay detecting an escape key-event. To exit edit mode quickly, double-press the escape key. ** These entries require key remapping in your terminal in order to work - see below). When in edit mode, emacs style key-bindings apply. Key Remapping By default, VT100 terminal emulators do not distinguish between Enter, Ctrl + Enter & Shift + Enter. In order to work around this, it is possible to re-map these key bindings so they produce the escape code of another key. To replicate the Ctrl + Enter & Shift + Enter of Jupyter, you will need to remap the following shortcuts in your terminal: Key Combination Output Ctrl + Enter Ctrl + F20 Shift + Enter F21 xterm Add the following to your ~/.Xresources *.vt100.translations: #override \n\ Ctrl Return: string("\033\[19;6~") \n\ Shift Return: string("\033\[20;2~") \n\ konsole In the menu, navigate to: Settings -> Edit Current Profile -> Keyboard -> Edit Change the existing entry for Return+Shift to Return+Shift+Ctrl (or whatever you prefer), then add the following entries: Key combination Output Return+Ctrl \E\[19;6~ Return+Shift \E\[20;2~ Roadmap * Add a configuration file to expose configurable settings * Add ability to dump formatted notebooks * Add command line argument parsing * Render outputs asynchronously in a separate thread * Cell attachements * LaTeX * Widgets Related projects * https://github.com/davidbrochart/nbterm An alternative effort sponsored by QuantStack * https://github.com/chentau/nbtui A cli Jupyter notebook viewer with support for kitty's terminal graphics protocol * https://github.com/mosiman/jupytui A cli Jupyter notebook viewer * https://kracekumar.com/post/jut/ Another cli Jupyter notebook viewer About Euporie is a text-based user interface for running and editing Jupyter notebooks Resources Readme License GPL-3.0 License Releases 1 tags Packages 0 No packages published Languages * Python 100.0% * (c) 2021 GitHub, Inc. * Terms * Privacy * Security * Status * Docs * Contact GitHub * Pricing * API * Training * Blog * About You can't perform that action at this time. You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.