Fix ScanSnap WebDAV service URL and simplify explanations
ci/woodpecker/push/woodpecker Pipeline was successful
Details
ci/woodpecker/push/woodpecker Pipeline was successful
Details
- Corrected URL from 192.168.1.119 to 192.168.0.119:9876 - Simplified technical explanations to focus on user experience - Added direct URL prominently in project descriptions - Removed complex WebDAV implementation details - Maintained key functionality information (fast scanning, auto-cleanup at 3am)
This commit is contained in:
parent
3c35c5eba0
commit
526da797c5
SSH Key Fingerprint:
SHA256:nRPCQTeMFLdGytxRQmPVK9VXY3/ePKQ5lGRyJhT5DY8
|
|
@ -303,15 +303,15 @@
|
|||
<h3><a href="stories/scansnap-webdav.html">ScanSnap WebDAV Service for buildersclub.ca</a></h3>
|
||||
<p>
|
||||
<strong>Timeframe:</strong> 2025-Present<br>
|
||||
<strong>Overview:</strong> Developed a high-performance WebDAV service specifically optimized for buildersclub.ca members to rapidly digitize receipts and documents using ScanSnap scanners.
|
||||
<strong>Overview:</strong> Developed a simple network scanner endpoint at <a href="http://192.168.0.119:9876" target="_blank">http://192.168.0.119:9876</a> that allows buildersclub.ca members to rapidly digitize receipts and documents using ScanSnap scanners.
|
||||
</p>
|
||||
<p><strong>Key Contributions:</strong></p>
|
||||
<ul>
|
||||
<li>Built a custom WebDAV server supporting up to 50 receipts per batch at ~1 scan per second processing speed.</li>
|
||||
<li>Implemented secure file isolation with automatic daily cleanup at 3:00 AM to prevent storage bloat.</li>
|
||||
<li>Optimized for macOS Finder WebDAV client compatibility with proper protocol responses and hotfixes.</li>
|
||||
<li>Designed zero-authentication system for streamlined trusted network deployment.</li>
|
||||
<li>Created automated cleanup scheduler using Python with configurable timing and manual override capabilities.</li>
|
||||
<li>Built a network scanner endpoint supporting up to 50 receipts per batch at ~1 scan per second processing speed.</li>
|
||||
<li>Implemented automatic daily cleanup at 3:00 AM to prevent storage bloat and maintain system performance.</li>
|
||||
<li>Created a simple system that works directly with macOS Finder - just press Command+K and enter the URL.</li>
|
||||
<li>Designed for the trusted clubhouse network environment with streamlined access.</li>
|
||||
<li>Set up automatic maintenance that requires zero user intervention or management.</li>
|
||||
</ul>
|
||||
<p><strong>Impact:</strong> Enabled buildersclub.ca members to rapidly digitize receipts and documents with enterprise-grade performance, reducing manual document processing time by 95% while maintaining secure file handling practices.</p>
|
||||
<p><a href="stories/scansnap-webdav.html" class="read-more">Read more about the ScanSnap WebDAV Service →</a></p>
|
||||
|
|
|
|||
|
|
@ -58,7 +58,7 @@
|
|||
<li><strong>Network Protocol:</strong> WebDAV 1.0/2.0 compliant</li>
|
||||
</ul>
|
||||
<p class="highlight-note">
|
||||
<strong>For buildersclub.ca members:</strong> <a href="http://192.168.1.119:9876" target="_blank">Access the scanner service here</a> (clubhouse network only)
|
||||
<strong>For buildersclub.ca members:</strong> <a href="http://192.168.0.119:9876" target="_blank">Access the scanner service here</a> (clubhouse network only)
|
||||
</p>
|
||||
</div>
|
||||
</section>
|
||||
|
|
@ -66,24 +66,14 @@
|
|||
<section class="technical-story">
|
||||
<h2>The Technical Journey</h2>
|
||||
|
||||
<h3>When Finder Refuses to Play Nice</h3>
|
||||
<h3>Simple Network Scanner Access</h3>
|
||||
<p>
|
||||
The first hurdle? Getting macOS Finder to actually connect to our WebDAV server. Turns out, Finder is incredibly
|
||||
picky about WebDAV implementations. It expects very specific protocol responses that many standard WebDAV libraries
|
||||
don't provide out of the box.
|
||||
The system provides a straightforward network location where the ScanSnap scanner can send documents directly.
|
||||
Just connect with Command+K in Finder, enter the URL, and you have instant access to a network drive ready for scanning.
|
||||
</p>
|
||||
<p>
|
||||
After digging through Finder's network traffic and WebDAV specs, I discovered it needed three specific "hotfixes"
|
||||
that mimic Windows server behavior:
|
||||
</p>
|
||||
<ul>
|
||||
<li><code>emulate_win32_lastmod</code> - Makes file timestamps work like Windows expects</li>
|
||||
<li><code>unquote_path_info</code> - Handles special characters in file names properly</li>
|
||||
<li><code>win_accept_anonymous</code> - Allows Finder to connect without credentials</li>
|
||||
</ul>
|
||||
<p>
|
||||
Once these were in place, Finder connected instantly. The whole experience felt native—just Command+K to connect,
|
||||
and boom, you've got a network drive ready for scanning.
|
||||
This creates a seamless experience - load your documents, hit scan, and they're immediately available on your computer
|
||||
without any additional steps or software.
|
||||
</p>
|
||||
|
||||
<h3>Security Without the Headache</h3>
|
||||
|
|
@ -222,11 +212,10 @@ schedule.every().day.at("03:00").do(cleanup_scans)</code></pre>
|
|||
dump files quickly, and users needed to grab those files easily. Mission accomplished with a fraction of the complexity.
|
||||
</p>
|
||||
|
||||
<h3>macOS WebDAV is Quirky</h3>
|
||||
<h3>Simple Network Integration</h3>
|
||||
<p>
|
||||
Apple's Finder WebDAV client has some very specific expectations that aren't always documented. The solution
|
||||
involved reading through protocol specs, analyzing network traffic, and testing various server configurations.
|
||||
Once you know the tricks (those three hotfix flags), it's actually rock solid.
|
||||
The solution integrates directly with macOS Finder, making it immediately familiar to users without requiring
|
||||
any special software or training. Connect once, and the scanner endpoint is always ready to receive your documents.
|
||||
</p>
|
||||
|
||||
<h3>Automatic Cleanup Changes Everything</h3>
|
||||
|
|
@ -243,7 +232,7 @@ schedule.every().day.at("03:00").do(cleanup_scans)</code></pre>
|
|||
<ul>
|
||||
<li><a href="../index.html">← Back to Portfolio</a></li>
|
||||
<li><a href="https://buildersclub.ca" target="_blank" rel="noopener noreferrer">buildersclub.ca</a></li>
|
||||
<li><strong>For Members:</strong> <a href="http://192.168.1.119:9876" target="_blank">Scanner Service Access</a> (clubhouse network)</li>
|
||||
<li><strong>For Members:</strong> <a href="http://192.168.0.119:9876" target="_blank">Scanner Service Access</a> (clubhouse network)</li>
|
||||
<li><a href="https://github.com/mar10/wsgidav" target="_blank" rel="noopener noreferrer">WsgiDAV Framework</a></li>
|
||||
<li><a href="https://www.fujitsu.com/us/products/computing/peripheral/scanners/scansnap/" target="_blank" rel="noopener noreferrer">Fujitsu ScanSnap Scanners</a></li>
|
||||
</ul>
|
||||
|
|
|
|||
Loading…
Reference in New Issue