diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 51 |
1 files changed, 44 insertions, 7 deletions
@@ -9,10 +9,14 @@ It allows you to capture images using [image scanners](https://en.wikipedia.org/ # Building from source -Install the dependencies (first line is Ubuntu/Debian, second is Fedora): +Install the dependencies + +For Ubuntu/Debian: ``` $ sudo apt install git meson valac libgtk-3-dev libgusb-dev libcolord-dev libpackagekit-glib2-dev libwebp-dev libsane-dev gettext itstool ``` + +For Fedora: ``` $ sudo dnf install -y meson vala gettext itstool gtk3-devel libgusb-devel colord-devel PackageKit-glib-devel libwebp-devel sane-backends-devel ``` @@ -25,28 +29,28 @@ $ cd simple-scan Build and run: ``` -$ meson --prefix $PWD/install build/ -$ ninja -C build/ all install -$ XDG_DATA_DIRS=install/share:$XDG_DATA_DIRS ./install/bin/simple-scan +$ meson --prefix $PWD/_install _build +$ ninja -C _build all install +$ XDG_DATA_DIRS=_install/share:$XDG_DATA_DIRS ./_install/bin/simple-scan ``` # Debugging -There is a --debug command line switch to enable more verbose logging: +There is a `--debug` command line switch to enable more verbose logging: ``` $ simple-scan --debug ``` Log messages can also be found in the `$HOME/.cache/simple-scan` folder. -If you don't have a scanner ready, you can use a virtual "test" scanner: +If you don't have a scanner ready, you can use a virtual `test` scanner: ``` $ simple-scan --debug test ``` This app works by using the [SANE API](http://sane-project.org/html/) to capture images. It chooses the settings it thinks are appropriate for what you -are trying to do. Drivers have many options and are of differring quality - it +are trying to do. Drivers have many options and are of differing quality - it is useful to work out if any issues are caused by the app or the drivers. To confirm it is a driver issue you can use the graphical tool (XSane) or the command line @@ -54,8 +58,41 @@ command line by the SANE project - these allow to to easily see and control all the settings your driver provides. +If XSane is also not working, then the issue could be casued by wrongly +loaded backend. To enable debug traces on Sane, set `SANE_DEBUG_DLL` +environment variable: + +``` +$ export SANE_DEBUG_DLL=255 +``` + +When set, SANE backends will show informational messages while +*Document Scanner* is running + +Example: + +With HP MFP 135a scanner, there is missing `libusb-0.1.so.4` +shared library, during loading `smfp` prioprietary backend: + +``` +[dll] sane_get_devices +[dll] load: searching backend `smfp' in `/usr/lib/x86_64-linux-gnu/sane:/usr/lib/sane' +[dll] load: trying to load `/usr/lib/x86_64-linux-gnu/sane/libsane-smfp.so.1' +[dll] load: couldn't open `/usr/lib/x86_64-linux-gnu/sane/libsane-smfp.so.1' (No such file or directory) +[dll] load: trying to load `/usr/lib/sane/libsane-smfp.so.1' +[dll] load: dlopen()ing `/usr/lib/sane/libsane-smfp.so.1' +[dll] load: dlopen() failed (libusb-0.1.so.4: No such file or directory) +``` + # Contributing To contribute code create merge requests on [gitlab.gnome.org](https://gitlab.gnome.org/GNOME/simple-scan). If you find issues please [report them](https://gitlab.gnome.org/GNOME/simple-scan/issues). + +## Translation + +A lot of information about translation process can be found at +[GNOME TranslationProject](https://wiki.gnome.org/TranslationProject/). +The translation files for *Document Scanner* User Interface and User Guide, +are available [here](https://l10n.gnome.org/module/simple-scan/). |