{"id":13820802,"url":"https://github.com/24eme/signaturepdf","last_synced_at":"2026-03-08T11:35:31.536Z","repository":{"id":37903734,"uuid":"364078086","full_name":"24eme/signaturepdf","owner":"24eme","description":"Free open-source web software for signing PDF (alone or with others) and also organize pages, edit medata and compress pdf","archived":false,"fork":false,"pushed_at":"2025-05-08T20:12:47.000Z","size":7969,"stargazers_count":511,"open_issues_count":44,"forks_count":62,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-05-11T16:46:29.470Z","etag":null,"topics":["js","pdf","pdf-compression","pdf-compressor","pdf-extraction","pdf-merge","pdf-meta-editor","pdf-metadata","pdf-rotate","pdf-sign","pdf-signature","pdf-signer","php","signature"],"latest_commit_sha":null,"homepage":"https://pdf.24eme.fr","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/24eme.png","metadata":{"files":{"readme":"README.fr.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":"SignaturePDF","issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2021-05-03T22:31:55.000Z","updated_at":"2025-05-10T01:12:29.000Z","dependencies_parsed_at":"2023-09-26T16:28:08.422Z","dependency_job_id":"317d8e7f-011d-4f0a-b662-c582cd34fdd3","html_url":"https://github.com/24eme/signaturepdf","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/24eme%2Fsignaturepdf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/24eme%2Fsignaturepdf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/24eme%2Fsignaturepdf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/24eme%2Fsignaturepdf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/24eme","download_url":"https://codeload.github.com/24eme/signaturepdf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254512805,"owners_count":22083463,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["js","pdf","pdf-compression","pdf-compressor","pdf-extraction","pdf-merge","pdf-meta-editor","pdf-metadata","pdf-rotate","pdf-sign","pdf-signature","pdf-signer","php","signature"],"created_at":"2024-08-04T08:01:09.331Z","updated_at":"2025-05-16T10:33:00.067Z","avatar_url":"https://github.com/24eme.png","language":"JavaScript","funding_links":["https://liberapay.com/SignaturePDF"],"categories":["JavaScript","Software","[🎛️ yunohost](https://github.com/stars/ketsapiwiq/lists/yunohost)"],"sub_categories":["Document Management"],"readme":"\u003csup\u003e**[Français](README.md)** | [English](README.en.md)\u003c/sup\u003e\n\n# Signature de PDF \n\nLogiciel web libre permettant de signer un PDF.\n\n## Instances\n\nListe des instances permettant d'utiliser ce logiciel :\n\n- [pdf.24eme.fr](https://pdf.24eme.fr)\n- [pdf.libreon.fr](https://pdf.libreon.fr)\n- [pdf.hostux.net](https://pdf.hostux.net)\n- [pdf.nebulae.co](https://pdf.nebulae.co)\n- [pdf.kaosx.ovh](https://pdf.kaosx.ovh)\n- [pdf.ti-nuage.fr](https://pdf.ti-nuage.fr)\n- [pdf.cemea.org](https://pdf.cemea.org)\n- [pdf.spirio.fr](https://pdf.spirio.fr)\n- [pdf.sequanux.org](https://pdf.sequanux.org)\n- [pdf.deblan.org](https://pdf.deblan.org)\n- [signpdf.liber-it.fr](https://signpdf.liber-it.fr)\n- [signaturepdf.linux07.fr](https://signaturepdf.linux07.fr)\n\n_N'hésitez pas à rajouter la votre via une issue ou une pull request_\n\n## License\n\nLogiciel libre sous license AGPL V3\n\n## Installation\n\n### Debian/Ubuntu\n\nDépendances :\n\n- php \u003e= 5.6\n- rsvg-convert\n- pdftk\n- imagemagick\n- potrace\n\nInstallation des dépendances :\n\n```\nsudo aptitude install php librsvg2-bin pdftk imagemagick potrace\n```\n\nRécupération des sources :\n\n```\ngit clone https://github.com/24eme/signaturepdf.git\n```\n\nPour le lancer :\n\n```\nphp -S localhost:8000 -t public\n```\n\n#### Configuration de PHP\n\n```\nupload_max_filesize = 24M # Taille maximum du fichier PDF à signer\npost_max_size = 24M # Taille maximum du fichier PDF à signer\nmax_file_uploads = 201 # Nombre de pages maximum du PDF, ici 200 pages + le PDF d'origine\n```\n\n#### Configuration d'apache\n\n```\nDocumentRoot /path/to/signaturepdf/public\n\n\u003cDirectory /path/to/signaturepdf/public\u003e\n    Require all granted\n    FallbackResource /index.php\n    php_value max_file_uploads 201\n    php_value upload_max_filesize 24M\n    php_value post_max_size 24M\n\u003c/Directory\u003e\n```\n\n### Déployer avec docker\n\n#### Construction de l'image\n\n```bash\ndocker build -t signaturepdf .\n```\n\n#### Lancement d'un conteneur\n\n```bash\ndocker run -d --name=signaturepdf -p 8080:80 signaturepdf\n```\n\n[localhost:8080](http://localhost:8080)\n\n#### Configuration\n\nLes variables suivantes permettent de configurer le déployement :\n\n| Variable               | description                                                        | exemple                          | defaut    |\n| ---------------------- | ------------------------------------------------------------------ | -------------------------------- | --------- |\n| `SERVERNAME`           | url de déploiement                                                 | `pdf.24eme.fr`                   | localhost |\n| `UPLOAD_MAX_FILESIZE`  | Taille maximum du fichier PDF à signer                             | 48M                              | 24M       |\n| `POST_MAX_SIZE`        | Taille maximum du fichier PDF à signer                             | 48M                              | 24M       |\n| `MAX_FILE_UPLOADS`     | Nombre de pages maximum du PDF, ici 200 pages + le PDF d'origine   | 401                              | 201       |\n| `PDF_STORAGE_PATH`     | chemin vers lequel les fichiers pdf uploadés pourront être stockés | /data                            | /data     |\n| `DISABLE_ORGANIZATION` | Desactiver la route Organiser                                      | true                             | false     |\n| `PDF_DEMO_LINK`        | Afficher, retirer ou changer le lien de PDF de démo                | false, `link` or `relative path` | true      |\n\n```bash\ndocker run -d --name=signaturepdf -p 8080:80 -e SERVERNAME=pdf.example.org -e UPLOAD_MAX_FILESIZE=48M -e POST_MAX_SIZE=48M -e MAX_FILE_UPLOADS=401 -e PDF_STORAGE_PATH=/data signaturepdf\n```\n\n### Alpine\n\nVoici un script permettant d'installer la solution sous Linux Alpine (testé en version 3.15).\nPensez à éditer la variable \"domain\" en début de script pour correspondre à l'URL avec laquelle elle sera appelée.\n\nLes composants principaux sont :\n\n- php 8 + php-fpm\n- Nginx\n- pdftk (installation \"manuelle\" nécessitant openjdk8)\n- imagick\n- potrace\n- librsvg\n\nCe que fait le script :\n\n- Installation des dépendances\n- Configuration de php et php-fpm\n- Configuration d'Nginx\n- Configuration du config.ini\n- Git clone du repo\n\n```\n#!/bin/sh\n\ndomain='sign.example.com'\n\napk update\napk add bash nginx git php8 php8-fpm php8-session php8-gd php8-fileinfo openjdk8 imagemagick potrace librsvg\n\ncd /tmp\nwget https://gitlab.com/pdftk-java/pdftk/-/jobs/924565145/artifacts/raw/build/libs/pdftk-all.jar\nmv pdftk-all.jar pdftk.jar\n\ncat \u003c\u003cEOF \u003e\u003epdftk\n#!/usr/bin/env bash\n/usr/bin/java -jar \"\\$0.jar\" \"\\$@\"\nEOF\n\nchmod 775 pdftk*\nmv pdftk* /usr/bin\n\nsed -i 's/user = nobody/user = nginx/g' /etc/php8/php-fpm.d/www.conf\nsed -i 's/;listen.owner = nginx/listen.owner = nginx/g' /etc/php8/php-fpm.d/www.conf\n\nsed -i 's/post_max_size = 8M/post_max_size = 50M/g' /etc/php8/php.ini\nsed -i 's/upload_max_filesize = 2M/upload_max_filesize = 50M/g' /etc/php8/php.ini\nsed -i 's/max_file_uploads = 20 /max_file_uploads = 300/g' /etc/php8/php.ini\n\nservice php-fpm8 restart\n\ncd /var/www\ngit clone https://github.com/24eme/signaturepdf.git\n\ncat \u003c\u003cEOF \u003e\u003e/etc/nginx/http.d/signaturepdf.conf\nserver {\n\n        listen 80 default_server;\n        listen [::]:80 default_server;\n\n        server_name ${domain};\n\n        client_max_body_size 0;\n\n        root /var/www/signaturepdf/public/;\n\n        index           index.php index.html;\n\n        location / {\n        # URLs to attempt, including pretty ones.\n        try_files   \\$uri \\$uri/ /index.php?\\$query_string;\n        }\n\n        location ~ [^/]\\.php(/|$) {\n                root /var/www/signaturepdf/public/;\n\n                fastcgi_split_path_info  ^(.+\\.php)(/.+)$;\n                fastcgi_index            index.php;\n                include                  fastcgi_params;\n\n                fastcgi_buffer_size 128k;\n                fastcgi_buffers 128 128k;\n                fastcgi_param   PATH_INFO       \\$fastcgi_path_info;\n                fastcgi_param   SCRIPT_FILENAME \\$document_root\\$fastcgi_script_name;\n                fastcgi_pass 127.0.0.1:9000;\n\n        }\n\n}\nEOF\n\nrm /etc/nginx/http.d/default.conf\nrm -R /var/www/localhost\n\nservice nginx restart\n\nrc-update add nginx\nrc-update add php-fpm8\n\nmkdir /var/www/signaturepdf/tmp\nchown nginx /var/www/signaturepdf/tmp\n\ncat \u003c\u003cEOF \u003e\u003e/var/www/signaturepdf/config/config.ini\nPDF_STORAGE_PATH=/var/www/signaturepdf/tmp\nEOF\n```\n\n## Configuration\n\n### Activation et configuration du mode partage de signature à plusieurs\n\nCe mode permet de proposer la signature d'un pdf à plusieurs personnes mais il nécessite que les PDF soient stockés sur le serveur, il convient donc de définir un dossier qui contiendra ces PDF.\n\nIl n'est pas obligatoire d'activer ce mode pour que l'application fonctionne c'est une option.\n\nCréer le fichier `config/config.ini`\n\n```\ncp config/config.ini{.example,}\n```\n\nDans ce fichier `config/config.ini`, il suffit ce configurer la variable `PDF_STORAGE_PATH` avec le chemin vers lequel les fichiers pdf uploadés pourront être stockés :\n\n```\nPDF_STORAGE_PATH=/path/to/folder\n```\n\nCréer ce dossier :\n\n```\nmkdir /path/to/folder\n```\n\nLe serveur web devra avoir les droits en écriture sur ce dossier.\n\nPar exemple pour apache :\n\n```\nchown www-data /path/to/folder/to/store/pdf\n```\n\n### Desactivation du mode Organiser\n\nPour desactiver le mode Organiser, ajouter `DISABLE_ORGANIZATION=true` dans le fichier\n`config/config.ini`.\n\n### Cacher ou modifier le lien de PDF de démo\n\nPour cacher le lien de pdf de démo, ajouter `PDF_DEMO_LINK=false` dans le fichier\n`config/config.ini`.\n\n### Champs chargés par défaut pour l'édition de métadonnéés\n\nDans le fichier de configuration `config/config.ini` il est possible de rajouter autant de champs que l'on souhaite avec le type HTML de l'input (text, date, number email, etc ...) qui seront préchargées pour chaque PDF.\n\n```\nMETADATA_DEFAULT_FIELDS[field1].type = \"text\"\nMETADATA_DEFAULT_FIELDS[field2].type = \"text\"\nMETADATA_DEFAULT_FIELDS[field3].type = \"date\"\nMETADATA_DEFAULT_FIELDS[field4].type = \"number\"\n```\n\n## Mise à jour\n\nLa dernière version stable est sur la branche `master`, pour la mise à jour il suffit de récupérer les dernières modifications :\n\n```\ngit pull -r\n```\n\n## Tests\n\nPour exécuter les tests fonctionnels :\n\n```\nmake test\n```\n\nLes tests sont réalisés avec `puppeteer` et `jest`.\n\nPour lancer les tests et voir le navigateur (en mode debug) :\n\n```\nDEBUG=1 make test\n```\n\n## Librairies utilisées\n\n- **Fat-Free** micro framework PHP : https://github.com/bcosca/fatfree (GPLv3)\n- **Bootstrap** framework html, css et javascript : https://getbootstrap.com/ (MIT)\n- **PDF.js** librairie de lecture de PDF dans un canvas HTML : https://github.com/mozilla/pdf.js (Apache-2.0)\n- **Fabric.js** librairie pour manipuler un canvas HTML : https://github.com/fabricjs/fabric.js (MIT)\n- **PDFtk** outils de manipulation de PDF (GPL)\n- **librsvg** outils de manipulation de SVG : https://gitlab.gnome.org/GNOME/librsvg (LGPL-2+)\n- **potrace** outils de transformation d'image bitamp en image vectorisé : http://potrace.sourceforge.net/ (GPLv2)\n- **OpenType.js** outils de transformation d'un texte et sa police en chemin : https://github.com/opentypejs/opentype.js (MIT)\n- **ImageMagick** ensemble d'outils de manipulation d'images : https://imagemagick.org/ (Apache-2.0)\n- **Caveat** police de caractères style écriture à la main : https://github.com/googlefonts/caveat (OFL-1.1)\n- **PDF-LIB** librairie js permettant de manipuler un PDF qui est utilisé pour écrire dans les métadonnées : https://pdf-lib.js.org/ (MIT)\n\nPour les tests :\n\n- **Jest** Framework de Test Javascript : https://jestjs.io/ (MIT)\n- **Puppeteer** librairie Node.js pour contrôler un navigateur : https://github.com/puppeteer/puppeteer (Apache-2.0)\n\n## Contributions\n\n### Traductions\n\nPour mettre à jour la traduction, exécutez simplement `make` qui mettra a jour le fichier `.pot`,\nqui fera un merge avec les fichiers `.po` qui permetteront de recréer les fichiers `.mo` mis a jour.\n\nDes traductions peuvent etre ajoutées sur Weblate : https://hosted.weblate.org/projects/signature-pdf/application/\n\n### Contributeurs\n\nCes personnes sont auteurices du code de ce logiciel :\n\nVincent LAURENT (24ème), Jean-Baptiste Le Metayer (24ème), Xavier Garnier (Logilab), Simon Chabot (Logilab), Tangui Morlier (24ème), Gabriel POMA (24ème), Tanguy Le Faucheur (24ème), Étienne Deparis, battosai30\n\n### Financements\n\n- 1 365 € HT de la société Logilab pour le développement du mode signature partagé à plusieurs\n- 1 950 € HT de la société Logilab pour le développement de l'édition des métadonnées\n- 100 € HT de don de la société Spirkop\n- 100 € HT de don de la société PDG IT\n- 1 040 € HT de la fondation NLNet pour l'internationalisation du logiciel\n\nLes modules signature et organiser ont été réalisés sur le temps de travail de salariés du 24ème.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F24eme%2Fsignaturepdf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F24eme%2Fsignaturepdf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F24eme%2Fsignaturepdf/lists"}