Patch Release v3.4.1

Change Notes

• Fix http(s) handling of storage and share urls
• Fix storage crawler HTTP header typo
• Fix Import Error: Missing lens.lns files
• Optimized gencert.sh SSL file generation
• Update lens crawler to bypass scrape blocking
• Update npm packages

Creator Release v3.4.0

Change Notes

• New group ID search support for lens creators
• New generic URL search support
• Improved and simplified lens storage logic
• Improved stability and reliability of lens crawling
• Improved codebase by outsourcing packages
• Fixed broken activation of most popular lenses
• Fixed broken thumbnails
• Adminer no longer starts automatically to save resources

Patch Release v3.3.4

Change Notes

• Added latest v0.9.x web crawler code
• Added temporary warning message when trying to activate non-working web lenses
• Fixed broken relay search
• Fixed various lens upload and cache import bugs
• Fixed 404 requests for WEBP images
• Fixed missing config option for crawler timeout
• Fixed bug where web lenses would not be marked as such

Important
Activating new web filters for the first time is currently not working and will be fixed with upcoming patches.

See also: Some news for all Lens Creators in 2025

Maintenance Release v3.3.0

Change Notes

• Fixed broken web search (no lenses showing)
• New upload API to import modified lenses
• New cache import option to allow overwriting of existing lenses
• New config options to control search timeout, caching and share urls
• Updated npm packages

Important
Activating new web filters for the first time is currently not working and will be fixed with upcoming patches.

See also: Some news for all Lens Creators in 2025

Patch Release v3.2.1

• Fixed lens placeholder image bug
• New config option to enable placeholder images (default: disabled)
• Updated sharp library

---

Upgrade Notes for v3.0/v3.1 users
If you are upgrading from v3.0/v3.1, you can overwrite all your existing server files.

1. Open up a Terminal/PowerShell
2. Switch path to your server directory with cd command
3. Run the docker compose up command inside your server directory

Upgrade will now happen automatically and may take some time.
You will see a bunch of connection error messages during the upgrade, don't worry about them.

The upgrade is complete if you see a similar log message:

Server upgrade from '50700' to '80036' completed.

Support Release v3.2.0

Change Notes

• Upgrade to MySQL 8.0.x for out of the box macOS ARM support
• Node 14 code compatibility (Node 16 is still the default)
• Migration of .env application settings to config.yml
• Fixed small bug with .webp to .png image conversion
• Updated npm packages

---

Upgrade Notes for v3.0/v3.1 users
If you are upgrading from v3.0/v3.1, you can overwrite all your existing server files.

1. Open up a Terminal/PowerShell
2. Switch path to your server directory with cd command
3. Run the docker compose up command inside your server directory

Upgrade will now happen automatically and may take some time.
You will see a bunch of connection error messages during the upgrade, don't worry about them.

The upgrade is complete if you see a similar log message:

Server upgrade from '50700' to '80036' completed.

Patch Release v3.1.1

• Fixed an issue where UUID's and some share URL's would not return a search result

Maintenance Release v3.1.0

• New configuration file config.yml for relay url's
• Relay Timeout handling and better search result experience
• Updated npm packages

Patch Release v3.0.1

• Storage server would point to wrong IP if server was hosted on remote computer

Web Crawler Release v3.0.0

• New web crawler to download Lenses from lens.snapchat.com
• Search by creator URL's e.g. => https​:​//​lensstudio​.​snapchat​.​com​/creator/wmF-q3w45OG4x4ZRmLGLoA
• Relay server with backed up Snap Lenses is now fully optional
• Better control over disk space usage with new .env settings
• New automatic database migration
• Reworked code and performance optimizations
• Bug fixes