mirror of
https://github.com/Frooodle/Stirling-PDF.git
synced 2025-12-18 20:04:17 +01:00
locally hosted web application that allows you to perform various operations on PDF files
af2e418129
# Description of Changes This pull request simplifies the workflow logic for the `docker-compose-tests` job in `.github/workflows/build.yml`. ### What was changed - Removed the extended conditional logic that depended on the results of the `test-build-docker-images` job. - Updated the `needs` configuration so that `docker-compose-tests` depends solely on `files-changed`. ### Why the change was made The previous logic attempted to optimize execution flow but introduced unnecessary complexity and conditional branches. By simplifying the workflow: - Job relationships become easier to understand and maintain. - The workflow executes more predictably. - The dependency graph becomes clearer, reducing potential misfires caused by mixed job states. --- ## Checklist ### General - [x] I have read the [Contribution Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md) - [x] I have read the [Stirling-PDF Developer Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md) (if applicable) - [ ] I have read the [How to add new languages to Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md) (if applicable) - [x] I have performed a self-review of my own code - [x] My changes generate no new warnings ### Documentation - [ ] I have updated relevant docs on [Stirling-PDF's doc repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/) (if functionality has heavily changed) - [ ] I have read the section [Add New Translation Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags) (for new translation tags only) ### Translations (if applicable) - [ ] I ran [`scripts/counter_translation.py`](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/docs/counter_translation.md) ### UI Changes (if applicable) - [ ] Screenshots or videos demonstrating the UI changes are attached (e.g., as comments or direct attachments in the PR) ### Testing (if applicable) - [ ] I have tested my changes locally. Refer to the [Testing Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md#6-testing) for more details. |
||
|---|---|---|
| .claude | ||
| .devcontainer | ||
| .github | ||
| .vscode | ||
| app | ||
| devGuide | ||
| devTools | ||
| docs | ||
| exampleYmlFiles | ||
| gradle/wrapper | ||
| images | ||
| scripts | ||
| testing | ||
| .editorconfig | ||
| .git-blame-ignore-revs | ||
| .gitattributes | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| build.gradle | ||
| CONTRIBUTING.md | ||
| DATABASE.md | ||
| Dockerfile | ||
| Dockerfile.dev | ||
| Dockerfile.fat | ||
| Dockerfile.ultra-lite | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| HowToUseOCR.md | ||
| launch4jConfig.xml | ||
| LICENSE | ||
| README.md | ||
| SECURITY.md | ||
| settings.gradle | ||
Stirling-PDF
Stirling-PDF is a robust, locally hosted web-based PDF manipulation tool using Docker. It enables you to carry out various operations on PDF files, including splitting, merging, converting, reorganizing, adding images, rotating, compressing, and more. This locally hosted web application has evolved to encompass a comprehensive set of features, addressing all your PDF requirements.
All files and PDFs exist either exclusively on the client side, reside in server memory only during task execution, or temporarily reside in a file solely for the execution of the task. Any file downloaded by the user will have been deleted from the server by that point.
Homepage: https://stirlingpdf.com
All documentation available at https://docs.stirlingpdf.com/
Features
- Parallel file processing and downloads
- Dark mode support
- Custom download options
- Custom 'Pipelines' to run multiple features in an automated queue
- API for integration with external scripts
- Optional Login and Authentication support (see here for documentation)
- Enterprise features like SSO (see here for documentation)
- Database Backup and Import (see here for documentation)
50+ PDF Operations
Organise
- PDF Multi Tool: Access merge, rotate, rearrange, split and delete actions from a single dashboard
- Merge: Combine multiple PDFs into one
- Split: Divide PDFs into multiple files
- Extract page(s): Extract specific pages from PDF
- Remove: Delete pages from PDF
- Crop PDF: Adjust PDF page boundaries
- Rotate: Rotate pages in 90-degree increments
- Adjust page size/scale: Resize page contents
- Multi-Page Layout: Add multiple pages to PDF
- PDF to Single Large Page: Convert to single continuous page
- Organize: Rearrange PDF pages
Convert to PDF
- Image to PDF: Convert images to PDF format
- Convert file to PDF: Convert various common file types to PDF
- URL/Website to PDF: Capture live webpages as PDFs
- HTML to PDF: Transform HTML documents to PDF
- Markdown to PDF: Convert Markdown files to PDF
- CBZ to PDF: Convert comic book archives
- CBR to PDF: Convert comic book rar archives
- Email to PDF: Convert email files to PDF
- eBook to PDF: Convert eBook formats (EPUB, MOBI, AZW3, FB2, TXT, DOCX) to PDF (using Calibre)
- Vector Image to PDF: Convert vector images (PS, EPS, EPSF) to PDF format
Convert from PDF
- PDF to Word: Convert to document (docx, doc, odt) format
- PDF to Image: Extract PDF pages as images
- PDF to RTF (Text): Convert to Rich Text Format
- PDF to Presentation: Convert to presentation (pptx, ppt, odp) format
- PDF to CSV: Extract tables to CSV
- PDF to XML: Convert to XML format
- PDF to HTML: Transform to HTML
- PDF to PDF/A: Convert to archival (PDF/A-1b, PDF/A-2b) format
- PDF to Markdown: Convert PDF to Markdown
- PDF to CBZ: Convert to comic book archive
- PDF to CBR: Convert to comic book rar archive
- PDF to Vector Image: Convert PDF to vector image (EPS, PS, PCL, XPS) format
- PDF to Video Slideshow: Export pages as an automated video presentation
Sign & Security
- Sign: Add digital signatures
- Remove Password: Remove PDF security
- Add Watermark: Apply watermarks
- Sign with Certificate: Certificate-based signing
- Add Stamp to PDF: Apply digital stamps
- Auto Redact: Automatically redact content
- Change Permissions: Modify access permissions
- Add Password: Apply PDF encryption
- Manual Redaction: Manual content redaction
- Remove Certificate Sign: Remove digital signatures
- Sanitize: Clean PDF of potential security issues
- Validate PDF Signature: Verify digital signatures
View & Edit
- OCR / Cleanup scans: Optical Character Recognition
- Add Image: Insert images into PDF
- Extract Images: Extract embedded images
- Extract Attachments: Retrieve embedded attachments
- Change Metadata: Edit PDF metadata
- Get ALL Info on PDF: Comprehensive PDF analysis
- Advanced Colour options: Colour manipulation (various options for colour inversion, CMYK conversion)
- Compare: Compare PDF documents
- Add Page Numbers: Insert page numbering
- Flatten: Flatten PDF layers, and interactive elements
- Remove Annotations: Delete comments and markups
- Remove Blank pages: Delete empty pages
- Remove Image: Delete embedded images
- View/Edit PDF: Interactive PDF editing
- Unlock PDF Forms: Enable form editing
- Add Attachments: Attach files to PDF
Advanced
- Compress: Reduce file size
- Pipeline: Automated workflow processing (OCR images pipeline, prepare PDFs for emailing pipeline)
- Adjust Colours/Contrast: Colour and contrast adjustment
- Auto Rename PDF File: Automatic file renaming
- Auto Split Pages: Automatic page splitting
- Detect/Split Scanned photos: Photo detection and splitting
- Overlay PDFs: Layer PDFs over each other
- Repair: Fix corrupted PDFs
- Show JavaScript: Display embedded JavaScript
- Auto Split by Size/Count: Split by file size or page count
- Split PDF by Chapters: Chapter-based splitting
- Split PDF by Sections: Section-based splitting
- Scanner Effect: Apply scanner-like effects
- Edit Table of Contents: Modify PDF bookmarks and TOC
📖 Get Started
Visit our comprehensive documentation at docs.stirlingpdf.com for:
- Installation guides for all platforms
- Configuration options
- Feature documentation
- API reference
- Security setup
- Enterprise features
Supported Languages
Stirling-PDF currently supports 40 languages!
| Language | Progress |
|---|---|
| Arabic (العربية) (ar_AR) | |
| Azerbaijani (Azərbaycan Dili) (az_AZ) | |
| Basque (Euskara) (eu_ES) | |
| Bulgarian (Български) (bg_BG) | |
| Catalan (Català) (ca_CA) | |
| Croatian (Hrvatski) (hr_HR) | |
| Czech (Česky) (cs_CZ) | |
| Danish (Dansk) (da_DK) | |
| Dutch (Nederlands) (nl_NL) | |
| English (English) (en_GB) | |
| English (US) (en_US) | |
| French (Français) (fr_FR) | |
| German (Deutsch) (de_DE) | |
| Greek (Ελληνικά) (el_GR) | |
| Hindi (हिंदी) (hi_IN) | |
| Hungarian (Magyar) (hu_HU) | |
| Indonesian (Bahasa Indonesia) (id_ID) | |
| Irish (Gaeilge) (ga_IE) | |
| Italian (Italiano) (it_IT) | |
| Japanese (日本語) (ja_JP) | |
| Korean (한국어) (ko_KR) | |
| Norwegian (Norsk) (no_NB) | |
| Persian (فارسی) (fa_IR) | |
| Polish (Polski) (pl_PL) | |
| Portuguese (Português) (pt_PT) | |
| Portuguese Brazilian (Português) (pt_BR) | |
| Romanian (Română) (ro_RO) | |
| Russian (Русский) (ru_RU) | |
| Serbian Latin alphabet (Srpski) (sr_LATN_RS) | |
| Simplified Chinese (简体中文) (zh_CN) | |
| Slovakian (Slovensky) (sk_SK) | |
| Slovenian (Slovenščina) (sl_SI) | |
| Spanish (Español) (es_ES) | |
| Swedish (Svenska) (sv_SE) | |
| Thai (ไทย) (th_TH) | |
| Tibetan (བོད་ཡིག་) (bo_CN) | |
| Traditional Chinese (繁體中文) (zh_TW) | |
| Turkish (Türkçe) (tr_TR) | |
| Ukrainian (Українська) (uk_UA) | |
| Vietnamese (Tiếng Việt) (vi_VN) | |
| Malayalam (മലയാളം) (ml_IN) |
Stirling PDF Enterprise
Stirling PDF offers an Enterprise edition of its software. This is the same great software but with added features, support and comforts. Check out our Enterprise docs
🤝 Looking to contribute?
Join our community: