Giter Club home page Giter Club logo

openairscan's Introduction

OpenAirScan - An example App using my package SwiftESCL

OpenAirScan is now available on the App Store:

Get OpenAirScan on the App Store

This repo contains an entire XCode project with a small example application using the protocol. If you're only interested in the actual API, I've created an XCode package (also MIT), that you can check out here.

Using the example application

Either download the App from the App Store or clone and compile the project to any modern iOS device. After opening the App, it will automatically start searching for devices supporting eSCL via Bonjour (it does need the local network permission for that) and display a list of results:

View of the main screen

Tapping a device will lead you to an overview of quick scan actions. You can just select the source and tap "Document" to scan a document. This will have the scanner use defaults for all other settings.

View of the quick actions list

If you want more granular control, you can tap "Custom scan". This will take you to the settings page where you can choose additional parameters like Resolution, Paper Size and File Format:

View of the settings page for a device

Pressing "Start scan!" will... start the scan. When the scanner is finished, you will be asked whether you want to scan more pages. This lets you scan documents with multiple pages even if your scanner doesn't support that natively. If you tap "Yes", the scanner will start scanning the next page right away. Pressing "No" will save all pages in a single PDF. "Cancel" discards all pages scanned. The scanned file is available in the "Documents" tab.

View of the documents tab

From there, you can use the default share sheet to do whatever you like with the document. You can also swipe left on a document in the list to delete it.

openairscan's People

Contributors

leoklaus avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

openairscan's Issues

Canon Pixma TS5300 is unsupported: malformed request

Hello! First of all - thank you for developing this app :) I tried to use it on my Canon Pixma TS5353, but sadly got errors:

IMG_0857

I saw the discussion in the issue with the HP scanner, so I went to /eSCL/ScannerCapabilities, and got this:

2.63Canon TS5300 seriesCanon00188b0e8fc000000000-0000-1000-8000-00188b0e8fc0http://7884F9000000.local./index.html?page=PAGE_AAPhttp://7884F9000000.local./icon/printer_icon.pngmopria-certified-scan1.212550135081Grayscale8RGB24PhotoTextTextAndPhotoHalftoneThruAutoimage/jpegapplication/pdfimage/jpegapplication/pdf757510010015015020020030030060060012001200sRGBNTSCDocumentPhotoPreviewTextAndGraphicAuto1200120000000111BackgroundReduction0101

I’m assuming Canon doesn’t pass this data as XML like other manufacturers (?).

I also checked the links in the string and the first one allows for changing the AirPrint settings and the second one is an image.

IMG_0858
IMG_0859

I guess the manufacturers try to make these interfaces as locked as possible so I don’t know if it’s even possible to support this printer, but let me know if more information is needed.

Default Settings Menu for Device Configuration Presets

Hello, and thank you for your hard work on this project!

Feature Request: It would be beneficial to include a default settings menu that allows users to easily configure and save their preferred device settings as presets. This feature would enhance usability by simplifying the setup process for frequent tasks.

Example Use Case: A user regularly scans documents using specific settings. Currently, they must manually set these each time. With the proposed feature, they could select a preset and have all settings applied automatically, saving time and effort.

Suggested Implementation:
A menu where users can create, name, and select presets for common tasks. For example:

  • Preset Name: A4 ADF Colour
  • Settings:
  • Scanner: User's Default Scanner
  • Format: A4
  • Mode: Colour
  • Output: PDF
  • Source: Document Feeder
  • Resolution: 300 DPI

This preset could then be selected from a drop-down menu or a dedicated settings page, applying all the specified settings instantly.

Benefit: This feature would streamline the workflow for users who perform repetitive scanning tasks, making the application more efficient and user-friendly.

Inspiration: The preset menu from NAPS2, which provides a good model for how such a feature could be structured and function.

I believe this enhancement would significantly improve user experience by reducing the number of steps required to set up frequent scanning operations. Looking forward to your thoughts on this suggestion!

HP m130 can not work

I can see the device in the search list, but when I click on it, I can't adjust all the settings. I think maybe the APP didn't ask eSCL URI 'ScannerCapabilities'?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.