{"id":5992,"date":"2014-03-02T11:33:09","date_gmt":"2014-03-02T16:33:09","guid":{"rendered":"http:\/\/g33kinfo.com\/info\/?p=5992"},"modified":"2014-03-02T11:33:09","modified_gmt":"2014-03-02T16:33:09","slug":"butterfly","status":"publish","type":"post","link":"https:\/\/g33kinfo.com\/info\/butterfly\/","title":{"rendered":"butterfly"},"content":{"rendered":"

 
\nFrom paradoxxxzero.github.io<\/a>
\n <\/p>\n

\n
\n

butterfly: your everyday terminal right in your web browser<\/h2>\n<\/header>\n
There’s something I’ve been working on recently, at start just for fun but it turned out I use it everyday, so here it is:
\n
\n\"butterfly
\n <\/p>\n

Try it<\/h2>\n

To try it, it’s as simple as:<\/p>\n

\nsudo pip install butterfly #Install butterfly
\nbutterfly.server.py # Launch the web server<\/code>\n<\/div>\n

Then all you have to do is go to : localhost:57575<\/a><\/p>\n

Use it<\/h2>\n

Server side<\/h3>\n

Run at start-up with systemd<\/h4>\n

As it relies on a server running in background, you can download the systemd file from here butterfly.service<\/a> put it in \/etc\/systemd\/system\/<\/code> or equivalent and:<\/p>\n

\nsudo systemctl enable butterfly
\nsudo systemctl start butterfly<\/code><\/p>\n<\/div>\n

Now the server will always be running.<\/p>\n

Running as root and multiple users<\/h4>\n

butterfly is made to work as the terminal user and as root. When running as root the privileges are dropped to the user that initiated the connection, i.e. the user that opened the web page. You can change the terminal user by going to localhost:57575\/user\/<user><\/a>.<\/p>\n

Access from a remote machine<\/h4>\n

You can set the bind host with butterfly.server.py --host=\"0.0.0.0\"<\/code> which will allow other users to connect to your terminal. A password will be asked but IT IS NOT SECURE! So it’s recommended as of now to run this only on local network for testing purposes.<\/p>\n

Run a specific shell<\/h4>\n

Use the shell<\/strong> command line option: butterfly.server.py --shell=\/bin\/fish<\/code><\/p>\n

Client side<\/h3>\n

butterfly works like any other terminal but it has some specific features.<\/p>\n

Enter browser shortcuts<\/h4>\n

When the terminal is focused all the hot-keys are caught (except from those the browser prevent to catch). If you want to access the address bar with CTRL + L<\/strong> it won’t work. That why the ALT + Z<\/strong> combination is here to tell butterfly that the next key combination must not be caught. In other word accessing the address bar is done by doing ALT + Z<\/strong> then CTRL + L<\/strong>. (If your browser support css3 filters the screen will turn sepia).<\/p>\n

Quick selection of history text<\/h4>\n

This is a feature I’ve always wanted to find in a terminal, quick history selection. I’ve started to implement some ideas you can try by hitting CTRL + SHIFT + up<\/strong> and then navigating the selection with CTRL + SHIFT + up\/down<\/strong> and the arrow keys. When you got it right, hit ENTER<\/strong> and butterfly will enter the selection right into the prompt:<\/p>\n

\"butterfly<\/p>\n

Other features<\/h2>\n