Repository files navigation

ShapeCrawler is a .NET library for manipulating PowerPoint presentations. It provides a simplified object model on top of theOpen XML SDK, allowing users to process presentations without having Microsoft Office installed.

• Quick Start
• How To?
  • Create presentation
  • More samples
• Prerelease Version
• Have questions?
• How to contribute
  • Bug Report
  • Code Contributing

dotnet add package ShapeCrawler

usingvarpres=newPresentation("pres.pptx");varshapes=pres.Slide(1).Shapes;varshapesCount=shapes.Count;// Get textvarshape=shapes.Shape("TextBox 1");vartext=shape.TextBox!.Text;

// create a new presentationvarpres=newPresentation();varshapes=pres.Slide(1).Shapes;// add new shapeshapes.AddShape(x:50,y:60,width:100,height:70);varaddedShape=shapes.Last();addedShape.TextBox!.SetText("Hello World!");pres.Save("my pres.pptx");

usingvarpres=newPresentation("pres.pptx");// get picture shapevarpicture=pres.Slide(1).Picture("Picture 1");// change imagevarimage=System.IO.File.OpenRead("new-image.png");picture.Image!.Update(image);// get MIME type of image, eg. "image/png"varmimeType=picture.Image!.Mime;pres.Save();

You can find more usage samples by visiting theWiki page orExamples.

To access the latest prerelease builds from the branchmaster, use the NuGet package sourcehttps://www.myget.org/F/shape/api/v3/index.json.

If you have a question:

• Join our Discussions Forum and open a discussion;
• You can always email the author attheadamo86@gmail.com

Give a star⭐ if you find this useful, please give it a star to show your support.

If you encounter an issue, report the bug on theissue page.

To be able to reproduce a bug, it's often necessary to have the original presentation file attached to the issue description. If this file contains confidential data and cannot be shared publicly, you can securely send it totheadamo86@gmail.com. Of course, if your security policy allow this. We assure you that only the maintainer will access this file, and it will not be shared publicly.

Pull Requests are welcome! Please read theContribution Guide for more details.

🍀Added Text Direction

VisitCHANGELOG.md to see the full change history.