# Using Ruby/Poppler without an X display

**URL:** <https://www.ruby-forum.com/t/using-ruby-poppler-without-an-x-display/164299>\
**Category:** Ruby-Gnome 2\
**Created:** [March 31, 2009, 12:27am UTC](https://www.ruby-forum.com/t/using-ruby-poppler-without-an-x-display/164299 "2009-03-31T00:27:07Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![raven13](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/b3f665/32.png) [@raven13](https://www.ruby-forum.com/u/raven13)\
**Post date:** [March 31, 2009, 12:27am UTC](https://www.ruby-forum.com/t/using-ruby-poppler-without-an-x-display/164299/1 "2009-03-31T00:27:07Z")

</div>

Hello.

I’d like to use Ruby/Poppler in a server context (Rails application) to  
render PDF documents. However, it appears that the Poppler bindings  
require the presence of an X display. For example, the following code  
will  
not run outside of an X session:

* * *

#!/usr/bin/ruby  
require ‘poppler’  
require ‘cairo’

filename = ARGV[0]

## document = Poppler::Document.new(filename) page = document.get\_page(0) (width, height) = page.size surface = Cairo::ImageSurface.new(width\_pt, height\_pt) context = Cairo::Context.new(surface) page.render(context) surface.write\_to\_png(‘test.png’)

The code fails with:

/usr/lib/ruby/1.8/gtk2.rb:12:in `init': Cannot open display: (Gtk::InitError) from /usr/lib/ruby/1.8/gtk2.rb:12 from /usr/lib/ruby/1.8/poppler.rb:6:in`require’  
from /usr/lib/ruby/1.8/poppler.rb:6  
from ./test\_pdf.rb:2:in `require’  
from ./test\_pdf.rb:2

(This is with ruby-gnome2 0.17, poppler 0.8.7 on Debian lenny)

AFAICT native Poppler itself can be used independently of an X session,  
so  
it’d be nice to have a way to achieve this using the Ruby bindings.

What would need to be done to make this work?

Any suggestions on how to proceed would be much appreciated.

Regards,

-mato

---

<div class="post-metadata">

**Author:** ![raven13](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/b3f665/32.png) [@raven13](https://www.ruby-forum.com/u/raven13)\
**Post date:** [March 31, 2009, 1:13am UTC](https://www.ruby-forum.com/t/using-ruby-poppler-without-an-x-display/164299/2 "2009-03-31T01:13:54Z")

</div>

Le mardi 31 mars 2009 à 00:25 +0200, Martin L. a écrit :

> What would need to be done to make this work?

Currently I think poppler will work fine without DISPLAY if you don’t  
have gtk2 binding installed but not if you have it :

begin  
require “gtk2”  
rescue LoadError  
end  
begin  
require “cairo”  
rescue LoadError  
end

If you just remove LoadError to catch other exceptions while loading  
gtk2 it may work

---

<div class="post-metadata">

**Author:** ![raven13](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/b3f665/32.png) [@raven13](https://www.ruby-forum.com/u/raven13)\
**Post date:** [March 31, 2009, 1:28am UTC](https://www.ruby-forum.com/t/using-ruby-poppler-without-an-x-display/164299/3 "2009-03-31T01:28:32Z")

</div>

[removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid) said:

> Currently I think poppler will work fine without DISPLAY if you don’t  
> have gtk2 binding installed but not if you have it :

I tried that, it didn’t work:

/usr/lib/ruby/1.8/x86\_64-linux/poppler.so:  
/usr/lib/ruby/1.8/x86\_64-linux/poppler.so: undefined symbol: mGdk -  
/usr/lib/ruby/1.8/x86\_64-linux/poppler.so (LoadError)  
from /usr/lib/ruby/1.8/poppler.rb:14  
from ./test\_pdf.rb:2:in `require’  
from ./test\_pdf.rb:2

There’s some kind of dependency in there I don’t understand…

-mato

---

<div class="post-metadata">

**Author:** ![raven13](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/b3f665/32.png) [@raven13](https://www.ruby-forum.com/u/raven13)\
**Post date:** [April 1, 2009, 4:46pm UTC](https://www.ruby-forum.com/t/using-ruby-poppler-without-an-x-display/164299/4 "2009-04-01T16:46:35Z")

</div>

Hi,

In [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid)  
“Re: [ruby-gnome2-devel-en] Using Ruby/Poppler without an X display”  
on Tue, 31 Mar 2009 01:27:24 +0200,  
Martin L. [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid) wrote:

> There’s some kind of dependency in there I don’t understand…

Add the following code before “require ‘poppler’”:

begin  
require ‘gtk2’  
rescue Gtk::InitError  
end

## Thanks,

kou

---

<div class="post-metadata">

**Author:** ![raven13](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/b3f665/32.png) [@raven13](https://www.ruby-forum.com/u/raven13)\
**Post date:** [April 1, 2009, 5:54pm UTC](https://www.ruby-forum.com/t/using-ruby-poppler-without-an-x-display/164299/5 "2009-04-01T17:54:12Z")

</div>

[removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid) said:

> Add the following code before “require ‘poppler’”:
> 
> begin  
> require ‘gtk2’  
> rescue Gtk::InitError  
> end

Thanks Kou, that works.

Looks like I’ll be using a different approach in any case, will write  
some  
minimal Ruby bindings for MuPDF[1], since Poppler pulls in far too many  
dependencies I don’t really want installed on a server.

Thanks anyway!

-mato

[1] [http://ccxvii.net/fitz/](http://ccxvii.net/fitz/)

---

<div class="post-metadata">

**Author:** ![raven13](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/b3f665/32.png) [@raven13](https://www.ruby-forum.com/u/raven13)\
**Post date:** [June 11, 2010, 4:47am UTC](https://www.ruby-forum.com/t/using-ruby-poppler-without-an-x-display/164299/6 "2010-06-11T04:47:58Z")

</div>

A better approach might be to require ‘gtk2/base’ instead? maybe  
poppler.rb should do that anyway…

Martin L. wrote:

> [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid) said:
> 
> > Add the following code before “require ‘poppler’”:
> > 
> > begin  
> > require ‘gtk2’  
> > rescue Gtk::InitError  
> > end
> 
> Thanks Kou, that works.
> 
> Looks like I’ll be using a different approach in any case, will write  
> some  
> minimal Ruby bindings for MuPDF[1], since Poppler pulls in far too many  
> dependencies I don’t really want installed on a server.
> 
> Thanks anyway!
> 
> -mato
> 
> [1] [http://ccxvii.net/fitz/](http://ccxvii.net/fitz/)
