Repository navigation
Releases
SantaCita 0.4.0-beta.2 — Search recovery and reliable migration
- Apply timing and ban-protection changes throughout the current search, including new browser sessions. Updating an active recovery pause no longer leaves the search waiting indefinitely.
- Use the configured click-retry, result-wait and restart delays. Retry only actions proven not to have been sent; uncertain submissions are never replayed. Refresh intervals and recovery jitter are sampled for each new wait, and sound reminders follow the profile interval.
- Preserve imported attempt budgets when SantaCita already has data. Restriction history survives a change of day without reviving recovered episodes. Repeated statistics imports retain
cod. operevidence, update existing episodes without duplicating them, and allow an interrupted first import to resume. - Correct an existing booking from Statistics without creating another achievement. Enter in a profile field keeps editing; saving remains an explicit action. The Work screen shows today's checks across runs, and Telegram recipient links display their actual lifetime.
- Show the owned Chrome, Chromium, Brave or Firefox window on macOS, restore the owned browser window on Windows, and request activation under X11/XWayland on Linux. If the desktop cannot activate the window, the app explains how to continue manually.
- Check console availability before requesting a diagnostic image and again before saving it. An unavailable lock state is reported separately from a confirmed screen lock; Windows/Linux images remain disabled until that state can be verified.
SantaCita 0.4.0-beta.1 — First SantaCita beta
- Introduce SantaCita, a new desktop application built with Rust, Tauri and Svelte for Toma de huellas / TIE and Autorización de regreso searches.
- Use an installed Chrome, Chromium, Brave or Firefox, or Edge on Windows, in a separate browser profile. A browser is no longer bundled. Linux snap versions of Firefox and Chromium are not supported.
- Import profiles, statistics, achievements and journals from the installed Python application while preserving the original data. Keep notification credentials in the system vault.
- Keep appointment dates, times, CAPTCHA and final confirmation manual. Continue to use per-profile search settings, protective pauses, persistent statistics and Telegram/webhook notifications.
- Offer stable and optional beta updates, verifying checksums and Sigstore build provenance before installation. Windows portable updates preserve the adjacent data folder.
- Provide optimized packages for macOS Apple Silicon and Intel, Windows MSI and portable, and Linux AppImage. This beta does not replace the stable Python release.
Cita Extranjeria Helper 0.3.8
0.3.8 — SantaCita migration and beta updates
- Prepare the updater for the move to SantaCita. Updates from both repository names keep the same checksum and build provenance checks; previously downloaded updates remain verifiable.
- Add Offer beta versions, off by default, to check stable releases and SantaCita betas. Beta versions are clearly marked, and downloading and installation remain manual.
- Explain the upcoming rename in all three README files, show a SantaCita migration notice in the update window, and point to manual downloads if an update cannot be verified. Document the manual Windows portable update steps.
Desktop packages for macOS (Apple Silicon / Intel), Linux x64 and Windows x64.
macOS: open the DMG and drag the app to Applications. Windows: run the MSI installer. Linux: make the AppImage executable and run it.
SHA256SUMS contains archive checksums. Each package includes a .sigstore.json build attestation verified before publication.
macOS uses an ad-hoc signature; Windows packages do not have an Authenticode signature.
Cita Extranjeria Helper 0.3.7
0.3.7 — Windows search stability and interface translations
-
Keep the search running on Windows when the window reads the attempt budget, profiles or achievements while the search process saves them. Saving now retries briefly instead of stopping the search process with
PermissionError. -
Make every unexpected search-process failure produce a startup report with code locations. Failed background budget saves are logged and retried on the next save; failures in background tasks and at process start are reported instead of ending with only an exit code. Reports keep module paths, line numbers and function names, never folders or profile data.
-
Fix garbled English and Spanish interface text such as “Untilбавить” on the Telegram recipient button. Short dictionary entries no longer translate parts of other words, and buttons, statistics labels and search timeline messages that were missing translations are now translated.
-
Keep the Camoufox button caption visible in the light theme when control is handed over for booking; it was white on a white background.
Desktop packages for macOS (Apple Silicon / Intel), Linux x64 and Windows x64.
macOS: open the DMG and drag the app to Applications. Windows: run the MSI installer. Linux: make the AppImage executable and run it.
SHA256SUMS contains archive checksums. Each package includes a .sigstore.json build attestation verified before publication.
macOS uses an ad-hoc signature; Windows packages do not have an Authenticode signature.
Cita Extranjeria Helper 0.3.6
0.3.6 — Windows folder fixes and achievement card
-
Start the browser on Windows when the application or its data is in a folder with non-ASCII characters, such as a Cyrillic user name or
Загрузки. The fingerprint model is now read through a Unicode-aware file handle, and the TLS intermediate cache loads the browser's NSS library through the folder's short Windows path. If the cache still cannot be opened, the browser starts anyway; HTTPS validation stays strict. -
Update the README workflow diagrams in all three languages and both themes: refresh the applicant form while the no-appointments message is visible, restart from sign-in when it disappears, and submit only after a pass without that message.
-
Add Reddit to achievement sharing and include the full current statistics in prepared text posts as well as PNG cards.
-
Refresh the shareable booking achievement card with a celebratory header, application icons and the full current search statistics in all three languages and both themes. New achievements preserve no-appointment counters, cod. oper responses, search days and first-event durations; unavailable fields in older snapshots remain unknown.
-
Keep translated donation buttons and the achievement header inside narrow windows. Size the Camoufox action to its label and preserve button content space when focused.
Desktop packages for macOS (Apple Silicon / Intel), Linux x64 and Windows x64.
macOS: open the DMG and drag the app to Applications. Windows: run the MSI installer. Linux: make the AppImage executable and run it.
SHA256SUMS contains archive checksums. Each package includes a .sigstore.json build attestation verified before publication.
macOS uses an ad-hoc signature; Windows packages do not have an Authenticode signature.
Cita Extranjeria Helper 0.3.5
0.3.5 — Submission pacing and Telegram alerts
- Include available office names and addresses in Telegram office-selection alerts. Repeated checks of the same office-selection page no longer send the alert again.
- Make daily attempt scheduling opt-in, including existing profiles. Clean passes can submit after protective pauses without waiting for a calendar window; the daily budget and adaptive statistics remain available.
- Show why a request is waiting, its deadline and a countdown. Keep today's scheduling choice when applicant details are copied from authentication and apply profile scheduling changes during the current search.
- Make Try now open the next opportunity from now and start a fresh pass in the same browser session. A warning prevents submission without consuming the opportunity. Minimum submission intervals and HTTP 429 protection remain active.
- Fit the Continue searching button to its translated label, icon and theme padding.
Desktop packages for macOS (Apple Silicon / Intel), Linux x64 and Windows x64.
macOS: open the DMG and drag the app to Applications. Windows: run the MSI installer. Linux: make the AppImage executable and run it.
SHA256SUMS contains archive checksums. Each package includes a .sigstore.json build attestation verified before publication.
macOS uses an ad-hoc signature; Windows packages do not have an Authenticode signature.
Cita Extranjeria Helper 0.3.4
0.3.4 — Search continuation and calendar offers
- Resume searching after the date-selection screen without clearing the browser session. Start a new pass in the same Camoufox window while preserving cookies, the attempt budget and protective pauses. Refreshing the site alone does not resume automation.
- Read offered dates and times from visible LIBRE cells in the appointment calendar, alongside the existing radio-button layout. Occupied, hidden and disabled cells are excluded.
- Restore the normal Start action after the booking browser has closed.
Desktop packages for macOS (Apple Silicon / Intel), Linux x64 and Windows x64.
macOS: open the DMG and drag the app to Applications. Windows: run the MSI installer. Linux: make the AppImage executable and run it.
SHA256SUMS contains archive checksums. Each package includes a .sigstore.json build attestation verified before publication.
macOS uses an ad-hoc signature; Windows packages do not have an Authenticode signature.
Cita Extranjeria Helper 0.3.3
0.3.3 — Daily budgets and interface improvements
- Adaptive budgets now have a minimum of five attempts, including previously saved estimates.
- Set a manual budget for today without disabling adaptation. It applies from the next action and expires at midnight. Used attempts and active restriction pauses are preserved, while the adaptive algorithm continues to learn for tomorrow.
- Edit the daily budget from Monitor, Statistics or profile settings. A compact pencil button opens a dialog showing the daily total, sent requests and remaining attempts. Restore the adaptive or base budget at any time.
- Read budget information more easily. The budget source appears in the edit button’s tooltip, and the next probe during a possible restriction appears on a separate line.
- Confirm booking appears after a date selection screen has been detected. Recording a booking remains manual. If detection was missed, use the actions menu to confirm it manually.
- Notification credentials are prepared before the search starts. Sending an office or booking alert no longer reads the secret store. Telegram settings on macOS explain when the system may ask for a Keychain password.
- Count each separate applicant page showing “No appointments”, even when the warning stays visible across refreshes. Recover earlier observations from saved journals when they can be matched to a recorded search session.
- Telegram recipient connection links now remain valid for five minutes.
- Stop search startup if notification credentials cannot be prepared; restore vault access or disable the affected channel before retrying.
- Allow disabling an unreadable notification channel or saving replacement credentials without losing the existing secret reference when disabling. Report profile-read failures instead of silently cancelling startup.
- Resume recipient detection when reusing a Telegram link after a polling error.
- Preserve journal visits beyond the last heartbeat and retry unmatched visits when their search session becomes available.
- Use “Try now” to bring the next attempt forward once, bypassing the budget window or
cod. operpause while keeping other protective delays and the clean-round check. - Changes to
cod. operpause settings recalculate an ongoing pause from its original start without restarting the search. - Fix repeated layout updates in a populated bot token field.
- Keep schedule calculations responsive when a very large attempt budget is configured.
Desktop packages for macOS (Apple Silicon / Intel), Linux x64 and Windows x64.
macOS: open the DMG and drag the app to Applications. Windows: run the MSI installer. Linux: make the AppImage executable and run it.
SHA256SUMS contains archive checksums. Each package includes a .sigstore.json build attestation verified before publication.
macOS uses an ad-hoc signature; Windows packages do not have an Authenticode signature.
Cita Extranjeria Helper 0.3.2
0.3.2 — Statistics and profile settings
- The “No appointments” counters now follow the Today or All time filter. The attempt budget still shows what remains today.
- Scroll through Settings and Timings without accidentally changing a number or a selection, even when the field is focused.
- Changes to ban protection take effect during the current search. To use your own attempt budget, turn off Adaptive budget and save the profile. The bot recalculates its attempt windows, keeps track of attempts already used today, and respects any ongoing pause after a
cod. operresponse. - Fix an app startup crash when a saved browser error contains braces. A damaged journal entry no longer prevents the rest of the timeline from opening.
Desktop packages for macOS (Apple Silicon / Intel), Linux x64 and Windows x64.
macOS: open the DMG and drag the app to Applications. Windows: run the MSI installer. Linux: make the AppImage executable and run it.
SHA256SUMS contains archive checksums. Each package includes a .sigstore.json build attestation verified before publication.
macOS uses an ad-hoc signature; Windows packages do not have an Authenticode signature.
Cita Extranjeria Helper 0.3.1
What's new in 0.3.1
Search and statistics
- See today's attempt budget while the bot is running. The Work tab shows how many attempts remain and when the next attempt or restriction check can happen.
- Slow down after HTTP 429. With adaptive timing enabled, each HTTP 429 response adds 30 seconds to the wait before refreshing the applicant form.
- Understand “No appointments” results. Statistics distinguish notices shown before submitting a request from replies received after submission. Replies containing
cod. operare counted for the selected period. - Review earlier searches. The timeline keeps recent entries across runs and app restarts. It also explains when a new pass starts to confirm that the “No appointments” notice has cleared.
Profile and startup fixes
- Saved timing changes take effect during the current search and survive browser restarts.
- Protection settings use switches with explanations on hover.
- Pressing Enter in a profile field no longer triggers validation. Validation runs when you save the profile.
- Camoufox retries startup on macOS if the display size prevents it from generating a browser fingerprint. This addresses the startup error reported in #23.
Installation
- macOS: choose the DMG for Apple Silicon or Intel and drag the app to Applications.
- Windows x64: run the MSI installer.
- Linux x64: make the AppImage executable and run it.
Use SHA256SUMS to verify downloads. Each package has a corresponding .sigstore.json build attestation. The macOS app is ad-hoc signed. Windows packages are unsigned.