0.11
No release in over 3 years
Low commit activity in last 3 years
A Ruby gem that can extract text and images from PowerPoint (pptx) files.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
>= 0
~> 3

Runtime

~> 1.6
~> 1.0
 Project Readme

<img src=“https://badge.fury.io/rb/ruby_powerpoint.svg” alt=“Gem Version” /> <img src=“https://ruby-gem-downloads-badge.herokuapp.com/ruby_powerpoint?type=total&total_label=downloads” alt=“Downloads” />

RubyPowerpoint – Parser for Powerpoint (pptx) files.¶ ↑

ruby_powerpoint is a Ruby gem that can extract title, content and images from Powerpoint (pptx) slides.

Installation¶ ↑

RubyPowerpoint can be used from the command line or as part of a Ruby web framework. To install the gem using terminal, run the following command:

gem install ruby_powerpoint

To use it in Rails, add this line to your Gemfile:

gem "ruby_powerpoint"

Basic Usage¶ ↑

RubyPowerpoint can parse a PowerPoint file (pptx) by extracting text and images from each slide:

require 'ruby_powerpoint'

deck = RubyPowerpoint::Presentation.new "specs/fixtures/sample.pptx"

deck.slides.each do |slide|
  slide.content # => ["Presentation Notes...", "12345"]
  slide.title # => "Prsentation Header"
  slide.images # => ["\xE3=\xA8h\x8E\x17\...."] Byte Stream
  # Saving the image byte stream to a file:
  File.open('temp.jpg', 'w'){|f| f.puts slide.images[0].read}
end

Contributing¶ ↑

Contributions are welcomed. You can fork a repository, add your code changes to the forked branch, ensure all existing unit tests pass, create new unit tests cover your new changes and finally create a pull request.

After forking and then cloning the repository locally, install Bundler and then use it to install the development gem dependencies:

gem install bundler
bundle install

Once this is complete, you should be able to run the test suite:

rake

Bug Reporting¶ ↑

Please use the Issues page to report bugs or suggest new enhancements.

License¶ ↑

RubyPowerpoint has been published under MIT License