PHPackages                             wpierre/scafo - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. wpierre/scafo

ActiveLibrary[File &amp; Storage](/categories/file-storage)

wpierre/scafo
=============

A bundle made for scanning and sorting paperwork

213PHP

Since Mar 12Pushed 11y ago2 watchersCompare

[ Source](https://github.com/WPierre/ScafoBundle)[ Packagist](https://packagist.org/packages/wpierre/scafo)[ RSS](/packages/wpierre-scafo/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Scafo - Scan &amp; Forget
=========================

[](#scafo---scan--forget)

Summary
-------

[](#summary)

Scafo is a simple tool helping you to sort all your paperwork. Scan all your bills, mail and such, define filters and let Scafo do all the work for you !
You might want to redirect Scafo's output to a file management software like [Pydio](http://pyd.io) or [OwnCloud](https://owncloud.com) so you can browse and search your documents.
Scafo is still in beta, so you can expect bugs.

How does it work ?
------------------

[](#how-does-it-work-)

For details, you should check the [documentation](/Documentation/howto.md).
Basically, you scan your papers in jpg files, put them in one of Scafo's Input folders, open Scafo's instance and run a sorting process. The scanned pages will be OCRized (the images will be converted to text) and according to the filters you defined, one of the filter will match your text and Scafo will know where to put the pdf file, how to name it and even how to extract the document's date.
Technically, Scafo requires a \*AMP server and a Symfony installation. Check out the instructions below to see how to set it up !

Help wanted
-----------

[](#help-wanted)

Scafo has a simple companion Java application that helps scanning your pages and sends the files directly in the good folder. Unfortunately, the only scanner library I managed to get working requires a personal (free, though) licence. Java isn't my cup of tea, so I'm looking for someone who could help me on this app so I can release it too.
Also, although this documentation is in english, Scafo is currently only available in french.

What kind of scanner is recommended ?
-------------------------------------

[](#what-kind-of-scanner-is-recommended-)

Any scanner will do, but a double-sided scanner with tray loading is highly recommended. A good, not-so-expensive scanner is the Canon P-150.

Setup
-----

[](#setup)

Note : All paths beggining with a slash refer to Symfony's root folder (ie : /var/www/scafo)

\###Symfony setup Install symfony 2.6 (or later) and set it up with a database. If you're not familiar with Symfony, please check [Composer](https://getcomposer.org/) and [Symfony](http://symfony.com/download) documentation. Basically, you have to run

> composer create-project symfony/framework-standard-edition scafo/

on your webserver.

\###Add Scafo Bundle

> php ../composer.phar require "wpierre/scafo":"dev-master"

\###Enable Scafo and the dependencies in Symfony Edit your /app/AppKernel.php and add the text below to the list of enabled bundles :

> new WPierre\\Scafo\\ScafoBundle\\WPierreScafoScafoBundle(),
> new WhiteOctober\\TCPDFBundle\\WhiteOctoberTCPDFBundle(),

\###Enable Scafo's routes Edit your /app/config/routing.yml and add :

> wpierre\_scafo\_scafo:
>  resource: "@WPierreScafoScafoBundle/Resources/config/routing.xml"
>  prefix: /
>  type: xml

Please mind the spaces if you're not familiar with YAML syntax (no leading space for the first line, four for the others).

\###Enable Symfony's form Bootstrap theme Edit your /app/config/config.yml and in the section "twig", add these lines :

> form:
>  #resources: \['bootstrap\_3\_layout.html.twig'\]
>  resources: \['bootstrap\_3\_horizontal\_layout.html.twig'\]

Same notice as previous step, four leding spaces for first line, eight for the next ones.

\###Install VirtualHost Set up a virtual host for your server. There's a standard Apache Virtualhost file ready to be adapted in The Scafo/ScafoBundle/Extra/VirtualHost folder. You might want to remove Symfony's /web/.htaccess file to enable the dev environnement on the front page while Scafo is still in beta stage.

\###Install the assets Scafo's bundle contains several assets, including Bootstrap and jQuery. You have to install them using :

> php app/console assets:install

You should see a line about ScafoBundle.

\###Setup the database Scafo needs a database and you configured one while installing Symfony. If the database already exists, please use :

> php app/console doctrine:schema:update --force

If it doesn't exist yet, please use :

> php app/console doctrine:database:create

\###Clear the caches Run these two commands to clear your Symfony caches :

> php app/console cache:clear --env=dev php app/console cache:clear --env=prod

\###Test it ! According to your virtual host configuration, this might change, but if you didn't change anything, open .
Scafo will run some test to check the dependencies and create your first instance. Open this instance and you can begin to put some files in one of the /app/Default\_repo/Input/ folders.

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/3e3d22ebfa24bae7a2fd21345a5442728f29db6e010b7571f7048aa1404ee3a8?d=identicon)[Wpierre](/maintainers/Wpierre)

---

Top Contributors

[![WPierre](https://avatars.githubusercontent.com/u/7423400?v=4)](https://github.com/WPierre "WPierre (13 commits)")

### Embed Badge

![Health badge](/badges/wpierre-scafo/health.svg)

```
[![Health](https://phpackages.com/badges/wpierre-scafo/health.svg)](https://phpackages.com/packages/wpierre-scafo)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
