Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pdfarranger/pdfarranger
Small python-gtk application, which helps the user to merge or split PDF documents and rotate, crop and rearrange their pages using an interactive and intuitive graphical interface.
https://github.com/pdfarranger/pdfarranger
gtk gtk3 linux pdf python3
Last synced: 4 days ago
JSON representation
Small python-gtk application, which helps the user to merge or split PDF documents and rotate, crop and rearrange their pages using an interactive and intuitive graphical interface.
- Host: GitHub
- URL: https://github.com/pdfarranger/pdfarranger
- Owner: pdfarranger
- License: gpl-3.0
- Created: 2015-10-21T19:30:19.000Z (about 9 years ago)
- Default Branch: main
- Last Pushed: 2024-12-28T10:56:31.000Z (14 days ago)
- Last Synced: 2024-12-31T14:03:57.619Z (11 days ago)
- Topics: gtk, gtk3, linux, pdf, python3
- Language: Python
- Homepage:
- Size: 2.38 MB
- Stars: 3,684
- Watchers: 34
- Forks: 216
- Open Issues: 46
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
- awesome-pdf - pdfarranger - gtk application, which helps the user to merge or split pdf documents and rotate, crop and rearrange their pages using a graphical interface (Manipulators)
- awesome-pdf - pdfarranger - gtk application, which helps the user to merge or split pdf documents and rotate, crop and rearrange their pages using a graphical interface (Manipulators)
- fucking-Awesome-Linux-Software - ](https://github.com/pdfarranger/pdfarranger/actions?query=workflow%3ACodeQL "Code quality workflow status")
[](https://app.codacy.com/gh/pdfarranger/pdfarranger/dashboard)
[](https://github.com/pdfarranger/pdfarranger/actions?query=workflow%3Apdfarranger+branch%3Amain)
[](https://codecov.io/gh/pdfarranger/pdfarranger)
*PDF Arranger* is a small python-gtk application, which helps the user to merge
or split PDF documents and rotate, crop and rearrange their pages using an
interactive and intuitive graphical interface. It is a front end for
[pikepdf](https://github.com/pikepdf/pikepdf).
*PDF Arranger* is a fork of Konstantinos Poulios’s PDF-Shuffler
(see [Savannah](https://savannah.nongnu.org/projects/pdfshuffler) or
[Sourceforge](http://sourceforge.net/projects/pdfshuffler)).
It’s a humble attempt to make the project a bit more active.
For more info see [User Manual](https://github.com/pdfarranger/pdfarranger/wiki/User-Manual).
## Downloads
| [PDF Arranger for Windows](https://github.com/pdfarranger/pdfarranger/releases) | 
| 
| [More…](https://github.com/pdfarranger/pdfarranger/wiki/Binary-packages) |
| --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
### Linux and BSD packages
[](https://repology.org/project/pdfarranger/versions)
## Install from source
*PDF Arranger* requires [pikepdf](https://github.com/pikepdf/pikepdf) >= 6.
Pip will automatically install the latest pikepdf if there is no pikepdf installed on the system.
**On Debian-based distributions**
```
sudo apt-get install python3-pip python3-wheel python3-gi python3-gi-cairo \
gir1.2-gtk-3.0 gir1.2-poppler-0.18 gir1.2-handy-1 python3-setuptools
```
**On Arch Linux**
```
sudo pacman -S poppler-glib python-pip python-gobject gtk3 python-cairo libhandy
```
**On Fedora**
```
sudo dnf install poppler-glib python3-pip python3-gobject gtk3 python3-cairo \
python3-wheel python3-pikepdf python3-img2pdf python3-dateutil libhandy
```
**On FreeBSD**
```
sudo pkg install devel/gettext devel/py-gobject3 devel/py-pip \
graphics/poppler-glib textproc/py-pikepdf x11-toolkits/gtk30 \
x11-toolkits/libhandy
```
**Then**
```
pip3 install --user --upgrade https://github.com/pdfarranger/pdfarranger/zipball/main
```
In addition, *PDF Arranger* supports image file import if [img2pdf](https://gitlab.mister-muffin.de/josch/img2pdf) is installed.
## For developers
```
git clone https://github.com/pdfarranger/pdfarranger.git
cd pdfarranger
./setup.py build
python3 -m pdfarranger
```
For Windows see [Win32.md](Win32.md).
For macOS see [macOS.md](macOS.md).
## For translators
Translations are located in the following files:
* [`po`](po)`/LANG.po` for interface translation strings
* [data/com.github.jeromerobert.pdfarranger.metainfo.xml](data/com.github.jeromerobert.pdfarranger.metainfo.xml) for repository integration
* [data/com.github.jeromerobert.pdfarranger.desktop](data/com.github.jeromerobert.pdfarranger.desktop) for desktop integration
If you are not comfortable working with git, **you may edit translations directly from Github's web interface**. However, in the normal case
you would contribute translations by following these steps:
* Download the main branch (see [For developers](#for-developers))
* Checkout a new branch to save your changes: `git checkout -b update-translation-LANG`
* Run `po/updatepo.sh LANG`, where `LANG` is the locale you'd like to update
* Update your translations in `po/LANG.po` file, and commit them; do not commit changes to `po/pdfarranger.pot` which may have been
automatically regenerated
* If possible, test your translation to see it in context (see [For developers](#for-developers))
* Create a new pull request with your changes to the main branch
If you are editing mnemonics accelerators (letters preceded by an underscore), here are some additional guidelines. However, if you have no idea what this means, don't worry about it.
Try to follow these rules by priority order:
* be consistent with other GTK/GNOME software
* pick a unique letter **within that given menu** if possible
* pick the same letter as the original string if available
* pick a strong letter (e.g. in "Search and replace" rather pick `s`, `r` or `p` than `a`)