zathura - a document viewer

mlq · 2011-03-15 10:13:13

zathura - a document viewer

zathura is a highly customizable and functional document viewer. It provides a minimalistic and space saving interface as well as an easy usage that mainly focuses on keyboard interaction.

Dependencies

girara-gtk2 (>= 0.1.3)
gtk2 (>= 2.18.6)
cairo (>= 1.8.8)

Plugins

Installation

Latest version (0.2.0): pacman -S zathura
AUR (git-version)

Development version

The version we are currently working on supports multiple file formats as well as continuous scrolling, and
also includes all known features from the latest stable version. We would welcome you to check it out and give
us feedback before we release it. It is available in the "develop" branch in our GIT repository.

Localization

Since 0.1.1 zathura supports translation, but at the moment we only provide english and german language files.
We need your help to get our projects translated into other languages. If you are interested, you can find all
necessary information here.

Bugs & Features

We are very happy about constructive feedback, bug reports and feature requests, but we ask you to use
our bug tracker for filling in those.

Links

Last edited by mlq (2012-06-09 22:09:24)

mlq · 2011-03-15 10:14:14

Reserved for additional information.

X-dark · 2011-03-15 12:44:47

Why recreating this thread and the jumanji one? They already exist here: https://bbs.archlinux.org/viewtopic.php?id=80458 and here https://bbs.archlinux.org/viewtopic.php?id=100505

Inxsible · 2011-03-15 14:02:08

The old threads have been closed at neldoreth's request and version 2 threads are now here.

jwhendy · 2011-03-16 16:16:29

I recently opened THIS and see that zathura does not have link-opening abilities. Is that a planned feature?

Runiq · 2011-03-16 16:58:26

It does have link-opening abilities, but you have to open them with the keyboard. Just like in vimperator/pentadactyl: Press f, press the number corresponding to the link you want to open, et voilà -- link opened.

Last edited by Runiq (2011-03-16 16:59:07)

ngoonee · 2011-03-21 09:20:52

With the new website, I'm not sure where configuration information can be found?

EDIT: Submitted two bugs and a feature request, thanks for the great software

Last edited by ngoonee (2011-03-22 02:56:42)

mlq · 2011-03-24 14:59:14

Hello,

zathura 0.0.8.3 has been released:

Updated text searching
Support for poppler >= 0.15
Fixed print command with multiple arguments
Fixed GOptionEntries
Updated Makefile
Fixed several memory leaks
Fixed segmentation faults

The package in the archlinux repository has already been updated. Keep in mind that this release has almost nothing to do with
the feature version of zathura, since it build upon a different code base.

Best regards

ngoonee · 2011-03-24 15:02:58

mlq wrote:

The package in the archlinux repository has already been updated. Keep in mind that this release has almost nothing to do with
the feature version of zathura, since it build upon a different code base.

Just to confirm, the 'feature version' refers to 'girara'?

mlq · 2011-03-24 15:04:48

Hello,

ngoonee wrote:

mlq wrote:
The package in the archlinux repository has already been updated. Keep in mind that this release has almost nothing to do with
the feature version of zathura, since it build upon a different code base.
Just to confirm, the 'feature version' refers to 'girara'?

Yes, the "feature version" is the one that is using libgirara and where the development is happening in the girara branch.

Best regards

jwhendy · 2011-03-24 16:58:51

@Runiq: thanks for the tip

Stalafin · 2011-03-24 19:07:33

Some time ago I read there are plans to change zathura to mupdf as a rendering engine. Is that still being worked on?

mlq · 2011-03-24 20:00:47

Hello,

Stalafin wrote:

Some time ago I read there are plans to change zathura to mupdf as a rendering engine. Is that still being worked on?

mupdf is used as a possible backend for zathura in the girara branch.

Best regards

Sébastien · 2011-03-30 14:48:12

Hello,

I was looking for something just like this, manupilating pdf in a vim way !

But I’m french and my keyboard is not in qwerty but bépo (a french dvorak keyboard), and right now it’s impossible to use this pdf viewer (jkl and h are spread across the keyboard).

So I’ve tried to change the config with a zathurarc file as explained on the website. But if it works sometimes, some other times it doesn’t. For example, this :

map + zoom in
map - zoom out

… just doesn’t work, and it’s from the zathurarc example file on the official website.

I’ve looked everywhere to find the config.h file and I didn’t. And I realised that you’ve got this file when you compile zathura, and I didn’t because I’ve got it from the ubuntu repository with apt-get.

So my question is : should I compile it in order to have this file (config.h) ?

I would love to move from ubuntu to archlinux but I don’t feel ready yet.

Thank you for your advices and your patience.

Sébastien.

ANOKNUSA · 2011-03-30 16:38:10

Sébastien wrote:

<snip>
I’ve looked everywhere to find the config.h file and I didn’t. And I realised that you’ve got this file when you compile zathura, and I didn’t because I’ve got it from the ubuntu repository with apt-get.
So my question is : should I compile it in order to have this file (config.h) ?
I would love to move from ubuntu to archlinux but I don’t feel ready yet.
Thank you for your advices and your patience.
Sébastien.

The file is found in the source package on git, and can be used to compile a version of Zathura with custom options. Though it's a bit confusing (Jumanji and Zathura still have little in the way of documentation), you can download the source, look over the config.h file, and transcribe the options in it you want to change to ~/.config/zathura/zathurarc.

Also, I'm not too familiar with Dvorak: might the "+" key still be "=" by default, a la QWERTY?

Last edited by ANOKNUSA (2011-03-30 16:48:28)

Sébastien · 2011-03-30 19:49:58

Thank you for your answer,

So I’ve got the "config.def.h" from the source package, and I searched inspiration from it for my zathurarc, but it’s still doesn’t work. Here are my tries :

map s navigate up
map t navigate down
map S navigate previous
map T navigate next

/* shortcuts */
Shortcut shortcuts[] = {
{0, GDK_s, sc_navigate_index, INDEX, { UP } },
{0, GDK_s, sc_navigate, FULLSCREEN, { UP } },
{0, GDK_s, sc_scroll, NORMAL, { UP } },

};

As you can see, the only things I really try to do for now, is to map going down with "t" and going up with "s" (the equivalent of "j" and "k" on my keyboard).
I tried all the things above individually and the only things that work properly is :

map S navigate previous
map T navigate next

… it was the example on the website (but it moves a whole page and I want also to move line by line).

About your question (ANONKNUSA) no the + is not on the default qwerty. On my keyboard, I’ve got it on "Alt gr + c".

So, if at least I manage to map "t" with down and "s" with up, I’ll be very happy.

A good documentation will be very good for this very good programm (in order to help motivated clumsy newbie like me !)

Thanks for your help !

ANOKNUSA · 2011-03-30 20:37:09

Give something like this a try:

map <SHIFT-T> navigate_next

You could also try "Shift-" or just a capital "S-"; the defaults work for me, so I haven't tried any custom key bindings myself.

Sébastien · 2011-03-31 09:08:39

Ok, it works fine now.

I did the compilation, so I could define all my keybindings as I wanted to.

I had to do it twice because first I had conflict with my keybindings. So maybe that was the same reason, when it didn’t work with the zathurarc file.

Thank you very much Anoknusa for your help.

Sébastien.

escherdragon · 2011-04-02 13:15:38

Hello,

Here is a patch (against 0.0.8.3) that improves marks by allowing them to record exact page positions in addition to the page number:
(apply with patch -p0 from the zathura compilation directory)

diff -Naur zathura.c zathura.c
--- zathura.c    2011-04-02 12:29:24.000000000 +0200
+++ zathura.c    2011-04-02 14:48:12.000000000 +0200
@@ -188,8 +188,15 @@
 
 typedef struct
 {
+  gdouble x;
+  gdouble y;
+} PagePosition;
+
+typedef struct
+{
   int id;
   int page;
+  PagePosition position;
 } Marker;
 
 typedef struct
@@ -385,6 +392,8 @@
 void set_completion_row_color(GtkBox*, int, int);
 void set_page(int);
 void switch_view(GtkWidget*);
+void save_page_position(PagePosition*);
+void restore_page_position(PagePosition*);
 GtkEventBox* create_completion_row(GtkBox*, char*, char*, gboolean);
 gchar* fix_path(const gchar*);
 gchar* path_from_env(const gchar*);
@@ -802,6 +811,7 @@
     if(Zathura.Marker.markers[i].id == id)
     {
       Zathura.Marker.markers[i].page = page_number;
+      save_page_position(&Zathura.Marker.markers[i].position);
       Zathura.Marker.last            = page_number;
       return;
     }
@@ -815,6 +825,8 @@
   Zathura.Marker.markers[marker_index].id   = id;
   Zathura.Marker.markers[marker_index].page = page_number;
   Zathura.Marker.last                       = page_number;
+
+  save_page_position(&Zathura.Marker.markers[marker_index].position);
 }
 
 void
@@ -1176,6 +1188,7 @@
     if(Zathura.Marker.markers[i].id == id)
     {
       set_page(Zathura.Marker.markers[i].page);
+      restore_page_position(&Zathura.Marker.markers[i].position);
       return;
     }
   }
@@ -1754,6 +1767,36 @@
 }
 
 void
+save_page_position(PagePosition* position)
+{
+  GtkAdjustment* adjustment;
+  adjustment  = gtk_scrolled_window_get_hadjustment(Zathura.UI.view);
+  position->x = gtk_adjustment_get_value(adjustment);
+  adjustment  = gtk_scrolled_window_get_vadjustment(Zathura.UI.view);
+  position->y = gtk_adjustment_get_value(adjustment);
+}
+
+void
+restore_page_position(PagePosition* position)
+{
+  GtkAdjustment* adjustment;
+  if(position->x > 0) {
+    adjustment = gtk_scrolled_window_get_hadjustment(Zathura.UI.view);
+    gtk_adjustment_set_value(adjustment, position->x);
+  }
+  else {
+    Argument argument;
+    argument.n = TOP;
+    sc_scroll(&argument);
+  }
+
+  if(position->y > 0) {
+    adjustment = gtk_scrolled_window_get_vadjustment(Zathura.UI.view);
+    gtk_adjustment_set_value(adjustment, position->y);
+  }
+}
+
+void
 switch_view(GtkWidget* widget)
 {
   GtkWidget* child = gtk_bin_get_child(GTK_BIN(Zathura.UI.viewport));

Cheers,

escherdragon · 2011-04-02 13:30:21

BTW, I think I have found a bug in the cb_view_kb_pressed() function: checking for if(Zathura.Global.mode == ADD_MARKER) and if(Zathura.Global.mode == EVAL_MARKER) should be done at the very beginning of the function, otherwise it's impossible to set marks using "a", "s" or any other character that is already mapped to an interactive function. Or am I missing something here?

Cheers,

r0b0t · 2011-04-13 20:05:08

I'm a "nano" guy and not a vim one, any tut or pdf on how to use this application?

I really don't understand anything in it.

Thank you

Stalafin · 2011-04-13 20:12:54

Man page?

karol · 2011-04-13 20:13:45

r0b0t wrote:

I'm a "nano" guy and not a vim one, any tut or pdf on how to use this application?
I really don't understand anything in it.
Thank you

Have you read the man page?

DEFAULT SETTINGS
   Shortcuts
       J      Go to next page

       K      Go to previous page

       h      Scroll to the left

       k      Scroll upwards

...

You can configure the keybindings your way https://pwmt.org/projects/zathura/configuration/

Last edited by karol (2011-04-13 20:15:16)

r0b0t · 2011-04-13 21:35:44

karol wrote:

r0b0t wrote:
I'm a "nano" guy and not a vim one, any tut or pdf on how to use this application?
I really don't understand anything in it.
Thank you
Have you read the man page?
DEFAULT SETTINGS
   Shortcuts
       J      Go to next page

       K      Go to previous page

       h      Scroll to the left

       k      Scroll upwards

...
You can configure the keybindings your way https://pwmt.org/projects/zathura/configuration/

Thank you for your reply, Yes I'v reed the man page and also I saw the configuration on pwmt.org and I'v seen also the config.h in the source.
I know how to move around with it like s to fit the page, J/K to go to next and previous, gg and GG to go to first page and last one , but I don't understand the imput methods (if there are ones) and some other stuff.
Here are some questions:

To digit a comand I should hit : and than a command but;

1) I bmark (2 pages) in one pdf, and thant :blist but nothing is shown. I suppose something should be shown right?

2) If I type :info than some info is shown but how to get out of this?

3) How should I type :

  ^f     Scroll page down

   ^b     Scroll page up

   ^d     Scroll half a page down

   ^u     Scroll half a page up

This means really ^ or something else ?
4) what's

       i      Change to insert mode  (--INSERT--) is shown, but what's the point on typing some characters in the bar below and how to get out of it?

       v      Change to visual mode   ?

Ty.

Last edited by r0b0t (2011-04-13 21:38:22)

karol · 2011-04-13 22:04:33

'^' means Ctrl. E.g. ^f means press and hold Ctrl and press f.

You can quit ':info' , insert mode and visual mode by hitting Esc.

Last edited by karol (2011-04-13 22:07:49)

Arch Linux

#1 2011-03-15 10:13:13