| Readme: | RemoteScan v1.0 beta - eSCL Network Scanner for MorphOS
=========================================================
IMPORTANT NOTE:
---------------
IT'S BETA VERSION!!!
If your scanner IP is not between 192.168.1 -> 192.168.1.254, RemoteScan
will don't find because it's the IP adresses where it search your scanner.
You should must add it manually in RemoteScan.conf after the first scan
(creation of the config file)
Network scanners have different answer to scan command, some scanner will send
a PDF, others JPG file...
Seems DPI option is not suported but don't hesitate to try.
In all case, don't hesitate to contact me to say me if it work or not on
papiosaur2@hotmail.fr
If you want to support me, you can offer me a coffe on www.ko-fi.com/papio
OVERVIEW
--------
RemoteScan is a command-line utility for MorphOS that enables network scanning
using the eSCL protocol. It automatically discovers compatible scanners on your
network and allows you to scan documents with customizable settings.
FEATURES
--------
- Automatic scanner discovery on local network
- eSCL protocol support (AirScan/AirPrint compatible scanners)
- Multiple output formats: JPEG, PNG, PDF
- Flexible resolution settings with automatic validation
- Color modes: RGB24, Grayscale8, BlackAndWhite1
- Configuration file support (saved to PROGDIR:)
- Parallel network scanning for fast discovery
- Verbose mode for debugging and detailed information
SYSTEM REQUIREMENTS
-------------------
- MorphOS 3.19+
- Network connection (same network as scanner)
- eSCL-compatible scanner (HP, Canon, Epson, Brother, etc.)
SUPPORTED SCANNERS
------------------
Any scanner that supports eSCL (also known as AirScan or AirPrint scanning):
- HP printers/scanners with wireless capabilities
- Canon PIXMA series with network support
- Epson Expression/WorkForce series
- Brother MFC/DCP series with network features
- Many other modern network-capable scanners
INSTALLATION
------------
1. Copy RemoteScan to your desired location
2. Make sure your scanner is connected to the same network
3. Run RemoteScan from the shell/terminal
QUICK START
-----------
The easiest way to get started:
1. Place a document on your scanner
2. Run: RemoteScan auto
3. Follow the on-screen prompts
This will automatically:
- Discover your scanner
- Save configuration to PROGDIR:RemoteScan.conf
- Scan the document
- Save to a timestamped file
COMMANDS
--------
discover
Scan the network for available eSCL scanners and save configuration.
Example: RemoteScan discover
scan
Perform a scan using saved configuration or specified parameters.
Example: RemoteScan scan -o mydocument.jpg
auto / quickscan
One-step command that discovers scanner, saves config, and scans.
Example: RemoteScan auto -o scan.pdf -f pdf -r 600
status
Check the current status of the scanner.
Example: RemoteScan status
capabilities
Display detailed scanner capabilities and supported settings.
Example: RemoteScan capabilities
COMMAND LINE OPTIONS
--------------------
General Options:
-h, --help Show help information
-V, --version Show version information
-v, --verbose Enable verbose output for debugging
-t, --timeout N Discovery timeout in seconds (default: 5)
-d, --device IP Specify scanner IP address (skips auto-discovery)
Scan Options:
-o, --output FILE Output filename (auto-generated if omitted with 'auto')
-f, --format FORMAT Output format: jpeg, png, pdf (default: jpeg)
-r, --resolution DPI Resolution in DPI (default: 300)
-q, --quality N JPEG quality 1-100 (default: 90)
-c, --color MODE Color mode: rgb, gray, mono (default: rgb)
-D, --duplex Enable duplex scanning (if supported)
-P, --preview Enable preview mode
USAGE EXAMPLES
--------------
Basic Usage:
RemoteScan auto
Auto-discover scanner and scan with default settings
Custom Output:
RemoteScan auto -o mydocument.pdf -f pdf
Scan to PDF format with custom filename
High Quality Scan:
RemoteScan scan -r 600 -q 95 -o highres.jpg
Scan at 600 DPI with 95% JPEG quality
Specific Scanner:
RemoteScan scan -d 192.168.1.100 -o document.png -f png
Scan from specific IP address to PNG format
Grayscale Scan:
RemoteScan scan -c gray -o grayscale.jpg
Scan in grayscale mode
Check Capabilities:
RemoteScan capabilities -v
Show detailed scanner capabilities
CONFIGURATION FILE
------------------
RemoteScan automatically saves scanner settings to PROGDIR:RemoteScan.conf
Example configuration:
# RemoteScan Configuration File
IP=192.168.1.100
PORT=80
DPI=300
FORMAT=JPG
You can manually edit this file if needed. The configuration is automatically
created when you run 'discover' or 'auto' commands.
RESOLUTION SETTINGS
-------------------
RemoteScan automatically validates requested resolutions against scanner
capabilities. Common resolutions:
- 75 DPI - Preview quality, small files
- 150 DPI - Web/email quality
- 300 DPI - Standard document quality (default)
- 600 DPI - High quality for text/graphics
- 1200 DPI - Very high quality (if supported)
If you request an unsupported resolution, RemoteScan will automatically
select the closest supported resolution.
COLOR MODES
-----------
- rgb : Full color (RGB24) - default
- gray : Grayscale (8-bit)
- mono : Black and white (1-bit)
OUTPUT FORMATS
--------------
- jpeg : JPEG format (adjustable quality)
- png : PNG format (lossless)
- pdf : PDF format (single page)
TROUBLESHOOTING
---------------
Scanner Not Found:
- Ensure scanner is powered on and connected to network
- Check that scanner supports eSCL (AirScan/AirPrint)
- Verify both MorphOS system and scanner are on same network
- Try specifying scanner IP manually with -d option
- Use -v (verbose) option for detailed discovery information
Scan Fails:
- Check that document is properly placed on scanner glass
- Ensure scanner lid is closed
- Wait for any previous scan jobs to complete
- Try with different resolution settings
- Use 'status' command to check scanner state
Empty or Small Files:
- Verify document is placed correctly on scanner
- Check that scanner glass is clean
- Try different resolution or format settings
- Ensure adequate lighting if using scanner with light sensor
Network Issues:
- Check network connectivity with ping
- Verify firewall settings aren't blocking connections
- Try different timeout values with -t option
- Some scanners may use non-standard ports
TECHNICAL NOTES
---------------
- Uses eSCL (Enhanced Scan Communication Language) protocol
- Supports HTTP and HTTPS connections
- Automatic port detection (80, 443, 8080, 9100)
- Parallel network discovery for fast scanner detection
- XML-based communication following PWG standards
- Compatible with AirScan/AirPrint scanning protocols
LIMITATIONS
-----------
- Network scanning only (no USB support)
- Single page scanning (no automatic document feeder support)
- Scanner must support eSCL protocol
- Limited to scanners on same network subnet
VERSION HISTORY
---------------
v1.0 - Initial release
- eSCL protocol support
- Automatic scanner discovery
- Multiple output formats
- Resolution validation
- MorphOS native implementation
SUPPORT
-------
For issues, questions, or feature requests, please check:
- Scanner documentation for eSCL/AirScan support
- Network configuration and connectivity
- MorphOS system requirements
LEGAL
-----
RemoteScan uses the eSCL protocol standard and is compatible with
AirScan/AirPrint enabled scanners. All trademarks are property of
their respective owners.
========================================================================
RemoteScan v1.0 - eSCL Network Scanner for MorphOS
|
Ambient (148)
RemoteScan-beta.lha