Frequently Asked Questions & Troubleshooting
Quick answers to common questions about RTILA X and this learning platform.
Getting Started
What is RTILA X?
A desktop web automation application that turns natural-language requests into executable scraping projects using a JSON configuration format and a Deno‑based browser engine.
How do I install RTILA X?
Download from rtila.com or GitHub Releases. The learning platform works in your browser; RTILA X runs on your desktop.
Do I need coding experience?
No. RTILA X uses a JSON configuration format. The AI assistant can generate configurations from natural language. This learning platform teaches you to understand and modify those configurations.
How do I run a scenario from this site?
Copy the project JSON from the scenario page, open RTILA X, create a new project, paste the JSON, and click Run. Compare your output with the Expected Output section.
Common Errors
I get 'selector not found' — what does this mean?
The CSS/XPath selector in your JSON does not match any element on the page.
Verify the selector against the Live Demo HTML on the scenario page. Common
causes: the page hasn't fully loaded (add wait_for_selector), the
class name changed, or you're missing the css= prefix.
The automation times out — what should I do?
Increase the timeout parameter in wait_for_selector or
navigation_timeout in settings. For slow sites, set
navigation_timeout to 60000. Also check if the site requires
CAPTCHA solving (enable captchaEnabled).
My extraction returns empty results
Check that item_selector matches the repeating container. Verify
property selectors are relative to the item, not absolute. Ensure the page has
fully loaded before extraction.
The script fails with 'export default' error
The run_script command requires a Deno module format. The script
must use export default async function(page, context, state, helpers)
— never arrow function syntax.
Selectors
What selector format does RTILA X use?
type=value format. Four types: css=, xpath=,
text=, variable=. Always include the prefix.
When should I use XPath vs CSS?
Use CSS for most cases (faster, simpler). Use XPath when you need text‑based selection or complex parent‑child traversal.
How do I handle elements inside iframes?
Use the iframe parameter on interaction commands, pointing to the
iframe's CSS selector.
Anti‑Bot & Stealth
What is humanoid mode?
When humanoidEnabled is true, RTILA X adds realistic mouse
movements, typing delays, and scrolling behaviour to reduce bot detection.
How do I handle CAPTCHAs?
Enable captchaEnabled in settings and configure a
captchaProvider (e.g., 2captcha) with your API key.
What is a browser profile?
A saved set of cookies, local storage and fingerprint characteristics. Use profiles to maintain login sessions across runs.
This Learning Platform
How is my progress tracked?
Progress is stored in your browser's localStorage. It persists across sessions but is device‑specific and browser‑specific. Clearing browser data will reset progress.
Can I sync progress across devices?
Not currently. Progress is local to each browser.
How do I report a problem with a scenario?
Use the "Was this helpful?" widget at the bottom of each scenario page, or visit the Community Forum.