Developer guide
Explore the plugin API, examples, and manifest reference. Start with the essentials and keep the guide open as you build.
Open the guideSupport
Get help with your image library, model files, materials, and licensing. Start with a feature below, or find a fix for a common issue.
Add a folder of pictures and 3D models. Oruva connects them, and Send to opens the model in your 3D app.
Set up your library ↗See how .max geometry, textures, and material graphs arrive in your chosen 3D app.
Apps & renderers ↗See how Make It Smart describes your previews so you can search by the details you remember.
Get search help ↗Browse preview images by category and bring matching images together in Smart Folders.
Organize your library ↗Extend Oruva with community plugins, or build your own with the SDK.
Plugin help ↗Trial, invoices, refunds, moving computers, Studio seats, and optional updates.
Purchasing answers ↗Getting started
Connect the images in your library to the models you already own.
Choose Add folder and point Oruva at your collection: pictures, 3D models, or a mix of both. Short steps show what was found and ask only what needs a decision.
Numbered views, shortened filenames, renderer or year suffixes, duplicate downloads, and model folder names or IDs help Oruva find likely connections. Close calls stay in Model Matcher for your review, and Oruva never renames or changes your files.
Select a picture and your destination. Oruva opens its connected model in your 3D app. Pictures still without a model appear under Missing Models.
Best practice: the same name, with extra views numbered -1, -2, -3. Names not perfect? Connect them once in Model Matcher and Oruva remembers.
Install the optional AI components inside Oruva, then use Make It Smart to describe and tag your preview images. Once they are tagged, search by the details you remember—color, material, shape, or a plain-language description. Visual search can also find a matching preview from a reference image.
Oruva checks the files inside the model folders you add under Library Preferences. It can connect exact names and numbered views, shortened descriptive names, renderer or year decorations, duplicate downloads and versions. When a download uses a descriptive folder around a generic MAX filename, the folder name or marketplace ID can identify the model inside. If several candidates remain plausible, Model Matcher leaves them for you to review.
Model Matcher (Tools → Model Matcher) shows pictures and model candidates in List or Gallery view, together with the reason for each suggestion. You can search the chosen model folders, connect all clear finds, pick a different candidate, drop in a model, or undo a connection. You can also right-click a picture and choose Connect to a 3D model….
Model files can be ZIP, RAR, 7Z, or MAX. Oruva only looks in the model folders you choose. Connecting records a relationship in your library; it does not rename, move, or change the picture or model file.
Moving to another computer? Library → Export Library Pack saves the library as one file and can include the connected 3D models. When the pack includes the connected models and you import those models, Oruva restores their library connections; missing or excluded models may need to be reconnected.
Browse your preview images by category, or bring matching images together in Smart Folders—saved searches that stay live as your library grows. Your models stay in the folder you chose.
Troubleshooting
Follow the guidance shown on the startup screen, then choose Try Again. If Oruva still won’t open, choose Save support report on the startup screen and email the record ID to support@oruva.app.
Oruva checks which renderers are available in your connected 3D app and disables targets that cannot run. Install the renderer and the Oruva connector for Cinema 4D, Blender, Maya, Houdini, or SketchUp, then reconnect. 3ds Max opens the extracted .max scene without an Oruva connector.
Close the destination application while its Oruva connector is installed or updated. Connector status shows missing, ready or update-needed for every destination; Blender supports 4.2–5.2 on Windows and 4.2–4.5 on macOS (Intel).
Index-in-place libraries depend on the original paths. Rescan or repair the library after moving originals. The app has verify and back-up tools for this.
The picture probably has no model connected yet. Open Tools → Model Matcher, or right-click the picture and choose Connect to a 3D model…, then pick the model or drop it in. Oruva remembers the connection. If the model is not listed, add its folder under Library Preferences → 3D Model folders. If the model was moved or deleted after connecting, connect it again from the same menu.
The texture check lists missing files before you send the model. Add the folder containing those textures and check again. If the model is already open in your 3D app, use its saved texture paths to relink the missing files.
Requirements
| Platform | Library, search & AI | 3D pipeline |
|---|---|---|
| Windows 10 / 11 · x64 | Available | Available |
| macOS | Available | Available |
| Linux | No package | |
Redshift in Maya and Houdini is in beta: it works and is supported, with less real-world testing than the other targets. Approximations are reported as usual.
Windows needs 8 GB RAM minimum for the library; 16 GB is recommended for local AI. Optional AI components check your hardware and free disk space before downloading.
macOS support on Intel processors includes library, search, local AI, 3D conversion, Designer, moodboards, Assistant, and plugins. Apple silicon support is coming.
Native destinations
Renderer support is explicit. Oruva only offers targets your connected application can actually receive.
| Destination | Supported versions | Renderer targets | Native file |
|---|---|---|---|
| 2024+ | .c4d | ||
| 4.2–5.2 on Windows · 4.2–4.5 on macOS (Intel) | .blend | ||
| 2024–2027 | .ma | ||
| 20.5–21.x | .hip | ||
| 2021–2026 | .skp | ||
| If installed | Uses the scene’s materials | .max |
Houdini 22 is not supported yet. SketchUp renderer support depends on the year: SketchUp 2026 supports V-Ray 7, Thea 4, and Enscape 4.19. Enscape is Windows-only.
Full prerequisites for renderer targets, connectors and Generator limits are on the download page.
Developers
Plugins add media-aware actions for images, video, audio, fonts, 3D, design files, archives and documents — either as a concise single-asset action or a full in-app interface.
Explore the plugin API, examples, and manifest reference. Start with the essentials and keep the guide open as you build.
Open the guideCreate a starter, link your project for live development, validate it, and package your plugin.
Build your first pluginA UI plugin receives the compatible selection in order, up to 512 unique files. A headless action receives a single asset.
Explore UI actionsPurchasing & licensing
A clear guide to your trial, purchase, computers, team, and updates. Find the answer you need below.
The trial gives you the full app for 14 days, with 10 conversions in total. An account is required. Use it to evaluate your own files, library, destination app, and renderer before purchasing.
Using all 10 conversions pauses conversion access; the rest of the app stays available until your 14 days end. Check the requirements first. Your destination application and any paid renderer are separate products and are not included with Oruva.
The trial includes 10 conversions in total, not per day. A conversion may be counted when Oruva reserves permission to convert a distinct source scene, before the finished result is created. Retrying the same source under the normal retry rules does not use another conversion.
A Scene Generator run counts as one conversion for the whole assembled scene. During the trial, a single run can include up to 3 models.
If a failed or interrupted conversion appears to have used an extra allowance, contact support@oruva.app with your account email and the message shown in Oruva. We can review the account record first; do not send the scene with your initial message.
The trial ends after 14 days. If you use all 10 conversions before then, only conversion access pauses; you can keep using the rest of the app for the remaining trial days. The trial and its conversion allowance are tied to your account and computer. Reinstalling Oruva, clearing its app data, or creating another account does not reset either.
If the trial appears to have expired before you could try Oruva, contact support with your account email and a screenshot of the message. We will check what happened.
No. Oruva uses your account instead of a serial number. Use your Oruva account email for the purchase, then sign in to that account in the app. Keep the purchase receipt for your records.
Do not share your password or account with another person. Studio gives each licensed team member their own account.
Use password recovery if you still have access to the email on your account. If you cannot access that email, write to support@oruva.app from an address you can use, and include the old account email and your purchase reference, if you have one.
We need to verify ownership before helping with an account or email change. Never send a password, full payment-card number, or security code. See the Privacy Policy for how account information is handled.
Individual: $99 one-time, for one person on up to two computers. Studio: $399 one-time for 5 named people, or $699 for 10 named people, each on up to two computers. Both are one-time license purchases with one year of updates included. There is no subscription.
These are launch prices, and they end on March 22, 2027. After that, Individual is $149, and Studio is $599 for 5 people or $999 for 10. Prices are in USD. The final price, currency, and any applicable taxes are shown at checkout, before you pay. Compare the plans.
For purchases through Paddle, Paddle is the seller and merchant of record and handles checkout, payment, applicable tax/VAT, invoices, and refunds. Choose from the payment methods offered for your location at checkout. Oruva does not receive your full payment-card details.
A receipt or payment statement may identify Paddle. You can look up a Paddle payment or get billing help at Paddle’s buyer support.
Check that payment completed and that you are signed in to the same Oruva account email used for the purchase. Connect to the internet so Oruva can check your license. If the purchase is still missing, contact sales@oruva.app with your account email and Paddle receipt or transaction reference.
If you used another email at checkout, include that address too. Do not buy a second license to fix an activation problem; we can help check the first purchase.
Look for Paddle’s purchase confirmation at the email used for checkout, including your spam folder. For a missing receipt, invoice, billing correction, or tax question, use Paddle’s buyer support and provide your transaction reference if available.
Enter your business name, billing address, and tax identification details at checkout where requested. Tax treatment depends on the buyer’s location and the details accepted by Paddle; a business purchase is not automatically tax-free. Contact us before paying if you need purchasing paperwork or have a billing requirement that checkout does not cover.
Check whether you received a purchase confirmation before trying again. A pending payment entry is not always a completed second purchase. Paddle’s buyer support can help identify the payment status.
If you have two completed purchases for the same intended license, send the transaction references to sales@oruva.app. We can identify the duplicate and help refund it without removing the purchase you intended to keep. See the Refund Policy.
An Individual license is for one named person on up to two computers they use, such as a workstation and a laptop. It covers personal and professional work. It is not a shared license for two people.
If several people need Oruva, choose separate Individual licenses or a Studio plan.
Yes. Your license follows your Oruva account across supported Windows and macOS versions, within the computer allowance for that user. You do not need to purchase the same license again just to change operating systems.
The available installer, processor, destination app, and renderer still need to match your setup. Check the downloads and compatibility requirements before switching.
Yes. Your license covers you on two computers, and replacing one never means buying again.
Moving to a new computer: on the old one, open Preferences → Account and choose Sign out and release. Its place is free at once. Two of these early transfers are available in any 30 days.
Removing a computer you cannot reach: it is cut off immediately, and its place becomes available when its offline access ends — up to 30 days for Individual, 90 days for Studio. Oruva shows you the exact date.
Lost, stolen or broken? Choose I can’t access my old computer. One automatic emergency replacement is available every 180 days; it is recorded on your account and confirmed by email. If you need another sooner, contact support for a free review — asking for help never cancels your license.
Do not send your password. A lost or broken computer does not make your license available to another person.
Your purchase belongs to your account. Reinstalling does not cancel it. Sign in to that account again and connect to the internet for a license check; contact support if the computer is not recognized as expected.
Your files are a separate matter. Back up your libraries, source assets, and project files before reinstalling an operating system or replacing a drive. Your Oruva account is not a cloud backup.
Uninstall Oruva from Windows Settings → Apps. To remove its settings and cache as well, tick Also remove my Oruva settings and cache during uninstall. Your libraries and 3D-app connections are always kept, so nothing you created is deleted by accident.
To remove a library, delete its folder yourself; you chose where it lives when you created it. To remove the Oruva connection from a 3D app, uninstall it from that app’s plug-in or add-on manager. If you need help removing anything, contact support@oruva.app.
Yes. A licensed user can use Oruva for professional and commercial work. Each person using Oruva needs their own licensed access, whether the computer is personally owned or provided by a company.
You remain responsible for the rights to your source assets and for any destination application or renderer licenses. Buying Oruva does not grant ownership or redistribution rights to third-party models. Read the Terms for the license conditions.
Studio 5 covers five named users, and Studio 10 covers ten named users. Each person uses a separate Oruva account. Each seat covers that user’s workstation and laptop, within the two-computer allowance.
Studio includes one year of updates and a longer offline conversion window of up to 90 days between successful license checks. See Studio pricing, or contact us for help matching a plan to your team.
No. Studio seats belong to named people, not a pool of simultaneous users. Team members should not share passwords or rotate a seat between different people from day to day.
Choose enough seats for the people who need Oruva. A genuine team change, such as someone leaving the company, can be handled through a seat reassignment.
Contact support@oruva.app from the purchasing or authorized company contact. Include the purchase reference, the departing user’s account email, and the replacement user’s email.
We will verify the request and help reassign the seat for a genuine personnel change. The departing user must stop using that seat. Do not hand over their account or password to the replacement user.
Contact us with your existing purchase reference and the number of people you need to cover. We can confirm the available plan, price, any credit for your existing purchase, and the update period before you buy.
Do not assume an automatic upgrade credit or a prorated price. We will agree the details with you first so you do not end up buying overlapping licenses.
Your first 12 months of updates start on the date of your license purchase. The current release available when you buy, and eligible releases during that period, are included. You can keep using the version you are entitled to after the update period ends, subject to the license and compatibility requirements.
Buying is a one-time license purchase. It does not enroll you in an automatically renewing subscription.
For Individual, another year of updates is an optional $59 purchase. For Studio, contact us for the renewal price for your team; the Individual renewal price does not cover an entire Studio package.
The renewal price and any taxes are confirmed before payment. Renewal is your choice, and we do not automatically charge you when the included year ends.
Yes. You do not have to buy the years you skipped. Renewing after a lapse includes the current release available when you renew and starts a new 12-month update period from the renewal purchase date, at the price confirmed before payment. Renewing early adds 12 months to your existing end date, so you keep the remaining months.
Until you renew, you can continue using your eligible version. Access to releases outside your paid update period requires a renewal.
Your right to use the version covered by your purchase does not expire just because you choose not to renew updates. That is the perpetual license.
Oruva still requires an account, and conversions require valid authorization, including periodic online license checks. A perpetual license does not mean a promise of permanent online service availability or compatibility with every future operating system, app, or renderer. The Terms explain these conditions.
With a valid paid license, conversions can work offline for up to 30 days for Individual or 90 days for Studio after a successful online license check. Reconnect and sign in when needed to refresh authorization.
If that window expires, conversion access needs a new online check; your local library and project files are not deleted. Account sign-in, purchases, and optional features that contact external services need an internet connection.
No. Your Oruva account handles access and licensing. It is not a cloud storage or automatic library-sync service. Keep your own backups, especially before changing computers, drives, or operating systems.
Your library and source assets stay on your machine unless you choose a feature that sends content elsewhere. The Privacy Policy explains local storage and optional external features.
Evaluate Oruva during the trial before you buy. Refunds are available for defined cases: duplicate completed payments, paid access we cannot deliver after checking the problem, or a substantial technical defect or material mismatch affecting an advertised feature or supported workflow that we cannot reasonably resolve. The same criteria apply to Individual licenses, Studio packages, and optional update renewals.
For Oruva's voluntary review of technical problems or non-delivery, contact sales@oruva.app or Paddle within 14 calendar days of payment, using the payment date on your receipt. This is a reporting deadline, not a money-back guarantee; a timely report remains timely while we investigate. Report duplicate payments when discovered. This deadline does not limit rights under Paddle's applicable terms or mandatory consumer law. See the Refund Policy for qualifying cases and request details.
Email sales@oruva.app with the reason for your request, your Oruva account email, and your Paddle transaction reference or receipt. If the checkout email differs from your account email, include both. Use the request period explained above and in the Refund Policy; your first request date is preserved while we review it.
Report duplicate completed payments when you discover them, including after 14 days. Mandatory legal rights are not limited by this request period. We aim to reply within two business days. Approved refunds are processed through Paddle to the original payment method where possible; see refund timing and status. You can also use Paddle’s buyer support for payment and refund-status help. Do not send card details, passwords, or confidential scene files.
First check the advertised compatibility requirements and use the trial with representative files. If you discover a substantial defect after purchasing, tell us your operating system, Oruva version, destination app and renderer versions, and a short description of the problem. Use Save support report in Preferences → Diagnostics or on the startup screen, and email the record ID to support@oruva.app. Our voluntary policy requires reasonable troubleshooting so we can verify the issue and try to resolve it. We will not delay a decision indefinitely or require you to disclose confidential project files; we can start with your description and the record ID from Save support report.
A substantial defect in an advertised supported feature or workflow that we cannot reasonably resolve can qualify for a refund. Knowingly purchasing for an unsupported setup or expecting an unadvertised feature does not normally qualify. Report the problem within the voluntary request period described above, without waiting for troubleshooting to finish. If applicable law gives you a remedy for a defective or misdescribed product after that period, those rights still apply. Using Oruva or conversions does not remove rights that cannot legally be waived.
If you made two completed payments for the same intended purchase, contact us with both transaction references when you discover the duplicate, even after 14 days. Tell us which purchase to keep. Refunding the confirmed duplicate does not remove the purchase you intended to retain.
A later discount, a forgotten promotional code, or a price change does not normally qualify for a refund or price adjustment. We do not offer automatic price protection or refunds to repurchase at a discount. See the discount and price-change policy. Any mandatory legal rights remain unaffected.
Refunding a license purchase removes the paid access supplied by that purchase. Refunding a Studio package removes the paid access for its seats. Any separate, valid access you have is unaffected.
Refunding an optional update renewal removes the update entitlement from that renewal; it does not cancel an earlier, unrefunded license purchase. Your right to use versions depends on the update period you still hold.
A refund does not delete your local library, source assets, or project files. It is also separate from an account-deletion request. See the Refund Policy and Privacy Policy.
Email sales@oruva.app with your account email and purchase reference, if you have one. For a team, include the number of people you need to cover. Keep passwords, payment-card details, and confidential project files out of your message.
Choose Save support report in Preferences → Diagnostics, or on the startup screen if Oruva will not open. Email support@oruva.app with the record ID and a short description of the problem. You can attach the saved report; it is encrypted so only Oruva support can read it. It contains opaque check codes, coarse device classes, app and OS versions, and at most four recent opaque event codes, plus basic report details. Nothing is uploaded automatically. Crash information stays on your computer.