Manatee

From HaskellWiki
Jump to navigation Jump to search

Introduction

Manatee is Haskell integrated environment written in Haskell.

The goal of the Manatee project is to provide a fast, safe and flexible integrated environment for haskell hacking.

You can consider it is new environment mix Gnome and Emacs. Like Gnome to provide friendly graphics interface and work efficient like Emacs.

Manatee use Multi-Process Framework, any extension (include core) running in separate process to protected core won't crash. So it minimize your losses when some unexpected exception throw in extension.

Manatee = Chrome (sandbox) + Emacs (behaviour) + GTK+ (render engine) + Haskell (concurrent) + Me (idea)

Many people ask me "What's Manatee?", i think correct answer should be :

   Depend on you how to use it. :)

NOTE

Manatee is not design for WM, it's design for OS, so don't compare it with XMonad, it's really different thing with XMonad. Please watch Window split feature carefully in video to understand the difference, Manatee can split unlimited window for same application :

   http://www.youtube.com/watch?v=weS6zys3U8k or  http://www.youtube.com/watch?v=A3DgKDVkyeM

In principle, Manatee just need Linux kernel and GTK+, don't need the help of "Window Manager" or "Desktop Environment".

Manatee is open application framework, you can write any extension or plugins for Manatee, I won't limit it, you just need follow some interface API i build.

This project still in early development, many features are missing, so i DON'T recommend use it as produce tool, just play it and report bug. :)

At last, Manatee is not Emacs, Manatee is not XMond, Manatee is not Gnome... it's a new software...

Video

HD version :

   http://www.youtube.com/watch?v=weS6zys3U8k

Above video include Owl City's music, if you can't watch it, try below video, without sound:

   http://www.youtube.com/watch?v=A3DgKDVkyeM

Chinese people (this version is not clear, please fighting GFW access YouTube.com):

   http://v.youku.com/v_show/id_XMjI2MDMzODI4.html

Screenshots

   http://goo.gl/MkVw

Hackage package

   http://hackage.haskell.org/package/manatee

IRC channel

   irc.freenode.net 6667 ##manatee

Mailing-List

   manatee-user@googlegroups.com 
   manatee-develop@googlegroups.com

Twitter

 https://twitter.com/manateelazycat

Installation

Below is build step for Manatee:

1) Install gold-linker to accelerate installation:

I suggest use gold-linker instead ld to accelerate installation.

In Debian system, you just need do below command:

sudo aptitude install binutils-gold -y

This step is optional, it's okay use ld link program, just much slow. :)

2) Install GHC compiler http://www.haskell.org/ghc/download_ghc_7_0_3:

Download ghc package for your system, then do below command :

./configure && sudo make install

3) Install C library: In Debian use below command:

sudo aptitude install libgtksourceview2.0-dev libgconf2-dev libwebkit-dev libcurl4-openssl-dev libgtkimageview-dev libpoppler-glib-dev poppler-data libtagc0-dev libvte-dev -y

4) Install cabal:

Download http://hackage.haskell.org/packages/archive/cabal-install/0.10.2/cabal-install-0.10.2.tar.gz

Decompress cabal-install-0.10.2.tar.gz and do below command:

cd ./cabal-install-0.10.2 && sudo chmod +x ./bootstrap.sh && ./bootstrap.sh

5) Install dependent Haskell library:

First make sure HOME/.cabal/bin/ in your PATH

Generic way is add `PATH=$PATH:~/.cabal/bin` in your ~/.bashrc

Then do below command (NOTE: don't use root permission with cabal, otherwise Manatee can't work):

cabal update && cabal install alex happy c2hs && cabal install gtk2hs-buildtools glib gio pango cairo gtk

6) Install Manatee:

Install all Manatee packages (same, don't use root permission):

cabal install manatee-all

If you don't want install all Manatee packages, you can install basic package like below:

cabal install manatee-core manatee-welcome manatee

Then choose extension package list in below to install:

manatee-browser
manatee-editor
manatee-filemanager
manatee-imageviewer
manatee-ircclient
manatee-mplayer
manatee-pdfviewer
manatee-processmanager
manatee-reader
manatee-curl
manatee-terminal

Note if you don't install any extension package, nothing will show in manatee, so you at least to choose one extension to install.

That's all, then type command manatee to play it! :)

I have test, Manatee can works well in Gnome, KDE, XMonad and XFCE

Quick start

When you first use Manatee, will show all manatee extension in a welcome tab. Just click to use it.

If you don't know keymap, just hit C-/ or C-?

Enjoy! :)

Report bug

Manatee is distributed framework, it allowed you install extension don't need depend each other, but it's easy to break if some package is older than core packages (manatee-core, manatee), so please make sure all packages has update to newest version before you report bug to manatee-user@googlegroups.com . Thanks! :)

Download source code

Download script from :

   https://patch-tag.com/r/AndyStewart/manatee/snapshot/current/content/pretty/repos.sh

And do

   sudo chmod +x ./repos.sh && ./repos.sh get

Source code will download at *parent* directory of reposh.sh, example, if repos.sh at /home/andy/, source code will download at /home

Customize

After change configure file, re-install current package will mix configure file to build your own version. (Or press "Ctrl + i" in current application)

Manatee developer can press "Ctrl + u" to debug configure file in runtime, you still need to re-install the current package if you want to start the configuration file take effect the next time,

You can find default configure template in package (manatee-*/Config directory)

How to write Manatee extension

Please look Framework before continue.

Template package at http://hackage.haskell.org/package/manatee-template

First, i explain Manatee package hierarchy:

  manatee-core contain DBus protocol detail and toolkit use in other manatee packages.
  
  manatee-welcome is use for show welcome page for manatee extension.
  
  manatee contain daemon process, 
  Daemon process is root process to manage other manatee processes:
  such as render application process' graphics for sandbox protected, window manage ... etc.
  Daemon process just do manage job and don't running any special application code in it.
   
  Other manatee-* package, such as manatee-editor, manatee-browser...etc running in
  it's own process, you can write any code to implement your application,
  just need follow some interface:

Manatee application interface:

instance PageBuffer TemplateBuffer where

   -- Get buffer name from Template buffer.
   pageBufferGetName           = readTVarIO . templateBufferFilePath
   -- Set buffer name.
   pageBufferSetName a         = writeTVarIO (templateBufferFilePath a)
   -- DBus client.
   pageBufferClient            = templateBufferClient
   -- How to create TemplateView from TemplateBuffer for multiple view design.
   pageBufferCreateView a pId  = PageViewWrap <$> templateViewNew a pId
   -- Page mode.
   pageBufferMode              = templateBufferMode
   -- Get package name to update user's configure.
   pageBufferPackageName _     = fmap takeFileName getDataDir
   -- Save buffer state.
   pageBufferWriteState        = templateBufferWriteState
   
   -- Restore buffer state.
   pageBufferReadState         = templateBufferReadState

instance PageView TemplateView where

   -- Page buffer.
   pageViewBuffer                = PageBufferWrap . templateViewBuffer
                                 
   -- GtkPlug id.                
   pageViewPlugId                = templateViewPlugId
                                 
   -- Page Frame.                
   pageViewFrame                 = templateViewFrame
                                 
   -- Local keymap.              
   pageViewLocalKeymap _         = templateViewLocalKeymap
   -- Command map.
   pageViewLocalCommandMap _     = templateViewLocalCommandMap
   -- How to focus when manatee focus current application.
   pageViewFocus                 = widgetGrabFocus . templateViewView
   -- Which widget to propagate event.
   pageViewPropagateWidget       = castToWidget . templateViewView
                                
   -- Save view state.          
   pageViewSaveState view        = templateViewSaveState view Nothing
   -- Restore view state.
   pageViewRestoreState view     = templateViewRestoreState view Nothing
   -- Save view state to file.
   pageViewWriteState view path  = templateViewSaveState view (Just path)
   -- Restore view state from file.
   pageViewReadState view path   = templateViewRestoreState view (Just path)
   -- How to handle cut action, can ignore.
   pageViewCut                 = templateViewCut
   -- How to handle copy action, can ignore.
   pageViewCopy                = templateViewCopy
   -- How to handle paste action, can ignore.
   pageViewPaste               = templateViewPaste
   -- How to scroll top postion, can ignore.
   pageViewScrollToTop         = templateViewScrollToTop
   -- How to scroll bottom postion, can ignore.
   pageViewScrollToBottom      = templateViewScrollToBottom
   -- How to scroll vertical page, can ignore.
   pageViewScrollVerticalPage  = templateViewScrollVerticalPage
   -- How to scroll vertical step, can ignore.
   pageViewScrollVerticalStep  = templateViewScrollVerticalStep
   -- How to scroll to left side, can ignore.
   pageViewScrollToLeft        = templateViewScrollToLeft
   -- How to scroll to right side, can ignore.
   pageViewScrollToRight       = templateViewScrollToRight
   -- How to scroll horizontal page, can ignore.
   pageViewScrollHorizontalPage= templateViewScrollHorizontalPage
   -- How to scroll horizontal step, can ignore.
   pageViewScrollHorizontalStep= templateViewScrollHorizontalStep

Todo

Optimise Code

Core

Perfect library gtk-serialized-event to support all GTK+ event

Support input method

Search class interface

Customize System

Convert haskell config to graphics make it easy to customize.

Browser

Javascript framework

Save password

Auto fill

Cache support

Integrate Google SafeBrowse.

IDE features:

Code completion

Code snippet

Fly check

Fly make

Integrated compiler

RSS/Atom reader

Offline view support

IRC client

SSL support (change code in library fastirc)

Support more command

Support private chat

Support log

Image Viewer

Display current image index

Fullscreen display

Support orientation, need binding library libextractor first.

Pdf Viewer

Support Zoom

Process Manager

Draw CPU log

Mail-Client

Support mail search

Support offline view

Org-Mode

Build OrgMode for TODO manage.

Session Manager

Support different layout switch

Proxy interface

Build rule to provide proxy interface for Manatee.

File Manager

Basic operation: create, copy, delete.

History forward/backward support.

Multi-Language dictionary

CHM viewer

Binding library libchm first.

PS viewer

Binding library libspectre first.

DVI viewer

Binding djvu first.

BT-Client

Twitter client

Terminal emulator

Use MVC design terminal emulator replace VTE widget, or patch to VTE to support MVC. :)