HANAVI User Guide — AI Video Editor

Get HANAVI and open it for the first time Copy link

Download HANAVI for Windows from hanavi.vn and run the installer. The installer is not code-signed yet, so Windows may warn you: click “More info”, then “Run anyway”. Open the app and install the libraries to import, preview and export video.

1. On the Projects screen, look for the Install libraries to get started card marked Step 1. It appears when the video processor is missing.
2. Click Open Integrated Library, then Download recommended. See “Install libraries to get started” to choose components and track downloads.
3. Once downloading and installation finish, close the Integrated Library and click Restart now in the restart dialog. Continue after HANAVI reopens.

To learn the controls on the current screen, press F1 and choose Quick tour.

• Read the guidance at the highlighted control. Click Next to continue or Back to revisit the previous step.
• Click Skip to stop, or Done on the last step. You can open the tour again through F1.

Install libraries to get started Copy link

Open the Integrated Library from the sidebar or from the Install libraries to get started card on the Projects screen. You can download components without signing in.

1. Select Download recommended to install the missing recommended components. For a single component, open its group, read the description and click Install on its card.
2. Watch the overall progress and the progress on each card. A component may wait in the queue before downloading and installing.
3. Wait for downloading and installation to finish. If a card shows an error, check the message, internet connection and free disk space, then click Retry.

• Essentials: video processing and importing video from links.
• Voices: on-device speech engines; read the descriptions to choose what you need.
• Listening: transcription, speaker recognition and detecting text printed in the film.
• Translation: translation through the HANAVI server or an installed on-device translator. Server translation needs no extra download but requires sign-in. Check Pricing and the in-app estimate before using a paid feature.

• Not installed: the component is not on this computer yet.
• Waiting: waiting its turn.
• Installing: downloading or installing; check the percentage and current step on the card.
• Installed: installed; newly installed libraries still require a restart before use.
• Install failed: installation failed; click Retry after checking the cause.

If export or dubbing is running, the button changes to Waiting for running jobs and is disabled. Wait for the job to finish, then restart. If HANAVI cannot restart itself, close the app and open it again.

Sign in with an email code Copy link

Sign in with a six-digit code sent to your email. Use an email address whose inbox you can access.

1. Click the account button at the top right to open HANAVI account. It shows Sign in when signed out, or your name or initials when signed in.
2. Enter your address in the Email field. Read and tick the consent box allowing HANAVI to use it for sign-in, verification codes and account notices.
3. Click Send code. If the address is invalid or consent is missing, follow the message to correct it and try again.
4. Open the email from HANAVI and enter its six-digit code in the 6-digit code from the email field in the app. The code is valid for 10 minutes.
5. Click Sign in On success, the dialog shows Signed in.

• Incorrect code: check your email and re-enter all six digits.
• Expired code or too many incorrect attempts: click Change email to return to the email step. Keep the current address or correct it, check consent, then click Send code for a new code.
• Connection error: check your internet connection and retry. If the app reports too many requests, wait before requesting another code.

Get familiar with the workspace and quick tour Copy link

Use the menus and quick tour to find controls on the current screen.

1. Open a project; inspect commands in File, View and Help.
2. Press F1, then choose Quick tour to see the current screen tour.
3. Read the highlighted area; use Next and Back to navigate. Finish with Done or stop with Skip.

• You can reopen the tour when needed.
• If a panel is hidden, use the Window menu to show it again.

Choose a channel and update the app Copy link

Choose a release channel and finish updating before continuing your work.

1. Open Settings and find Update Channel. Choose Stable or Early access.
2. Use Check for Updates. When a version is available, select Update now and watch download and installation preparation.
3. When ready, select Restart to update. Wait for export or dubbing to finish if requested.

• Early access gets versions first and may have bugs.
• Download failed: check the connection and select Try again. Keep using this version is available after a download failure unless a required update blocks Export.
• If an update is required to export, finish updating before reopening Export.

Choose a type and create a project Copy link

Create a project with the right workflow and frame before importing media.

1. On Projects, open the project creation menu and choose Video editing or Film dubbing.
2. Enter a name in Project name, then select Frame.
3. Select the project type in the dialog to create and open its workspace.

• Invalid name: follow the message below the name field and try again.
• Check the frame before adding clips; choose landscape or portrait for your destination.

Package a project for another computer Copy link

Package a project and its media in use into a .hanavi file to open on another computer.

1. In the Windows app, open the project and use Package project….
2. Read the description, select Package and choose a filename that does not exist.
3. Transfer the .hanavi file; use Open project package…, select Import and choose the package.
4. Open the new project created from the package, check media and preview before exporting.

• Packaging failed: check media and the destination filename.
• Opening failed: check the .hanavi file and available disk space.

Import and manage media Copy link

Bring video, images and audio into a project and check which files are in use.

1. Open Media in Video editing and use the import command to select local files.
2. Choose media and place it on a suitable timeline track.
3. Open Media management to inspect project files, usage indicators and missing files.

• Missing file: select a replacement source in Media management.
• Check clips using the replacement; relinking preserves cuts and timing.

Cut and arrange clips on tracks Copy link

Split clips and rearrange video on the timeline.

1. Select a clip and move the playhead to the cut.
2. Use Split clip or Ctrl+Shift+K.
3. Drag the clip to its new track position. Preview the join and use Ctrl+Z to undo if needed.

• If the command is unavailable, check the selection and that the playhead is inside the clip.
• Locked clips cannot be edited; read the message before retrying.

Preview and export video Copy link

Review the edit, export it and check the resulting file.

1. Move the playhead to the beginning and play; inspect picture, text and sound at joins.
2. Use Shift+F11 for the full-screen viewer; F11 makes the whole HANAVI app full screen.
3. Open Export with Ctrl+E, select settings and a destination, then start exporting.
4. Wait for completion, open the exported file and check it from beginning to end.

• Export failed: read the message, check media, storage and destination, then retry.
• If an update is required to export, see Choose a channel and update the app.

Adjust a clip picture and speed Copy link

Select a clip to adjust its picture and speed, then preview at the playhead.

1. Select a picture clip on the timeline and open Properties.
2. Adjust position, size or colour in the available groups; review the picture after each change.
3. For a supported video or audio clip, select Speed. Play it to check the picture and its accompanying sound.

• Higher speed shortens the clip and changes its accompanying sound.
• A speed change is refused if it would cover the next clip.
• The film track in Final edit keeps its original speed for dubbing alignment; still images have no speed control.

Add text and motion Copy link

Add a title, then adjust its text and motion.

1. Open the text panel, enter content, choose a style and add it to the timeline.
2. Select the text clip to adjust font, size, colour and layout in Properties.
3. Open Motion; choose entrance motion, Out or Loop, then preview both ends of the clip.

• If text is hidden, check position, size and timing.
• If motion is invalid, reduce its duration as requested by the app.

Add effects Copy link

Apply an effect to a clip and compare the picture before and after adjustment.

1. Open Effects and find an effect.
2. Drag its card onto the target picture clip on the timeline.
3. Select the effect clip on the track above to adjust settings in Properties; preview the affected area.

• Invalid drop: read the message and drop onto a supported clip.
• Remove the selected effect if the result is unsuitable, then check the picture again.

Add transitions Copy link

Place a transition at the join between two touching picture clips on the same track.

1. Arrange two picture clips so they touch on the same track.
2. Open Transitions, choose a card and duration, then drag it onto the join.
3. Play through the join; select the clip to adjust or remove the transition in Properties.

• A gap or the last clip on a track cannot transition to a next clip.
• Duration must be positive and no longer than either clip.

Add music and duck it under narration Copy link

Add background music and lower it during narration to keep speech clear.

1. Import music or choose it in the audio panel; preview it and add it to an audio track.
2. Adjust the music track level and check the project narration.
3. Enable the music track option to dip under narration. Play a narrated section and one without speech to compare levels.

• No narration yet: you can enable it in advance; later narration will dip the music.
• If speech is still unclear, reduce music and listen again; also check the exported file.

Use the video editing assistant Copy link

Open AI Assistant to check availability for your account. If no AI source is ready, use AI rough cut to begin.

1. Open a Video editing project and the AI Assistant panel.
2. If requested, select Sign in at the top right, then reopen the panel.
3. Read the status. If the server assistant says it opens soon, switch to AI rough cut to build an edit from your media.

• After signing in, check the assistant status in the panel.
• When an available source allows proposals: enter a request, generate a proposal, review each change, then apply it.
• Timeline changed after proposal generation: generate a new proposal. Do not apply the stale one.

Create a rough cut from media Copy link

AI rough cut selects shots from your videos and builds the draft right in the project you have open. If the project already has content or uses a different frame, HANAVI asks first: replace it with the draft or create a new project.

1. Import videos into Media, then open AI rough cut.
2. Select media, choose an Editing templates option and preview it. Set Duration, Frame and an optional description.
3. Choose original subtitles or automatic narration if needed; pick a voice by gender, region and suitable style.
4. Review the estimate in the app and Pricing, then select Create rough cut.
5. If the project already has content, choose Replace with the draft (can be undone) or Create a new project. If the frame differs, choose to change this project's frame or create a new project. A project that uses sequences can only create a new project.
6. Review the draft in the project (or in the new project if you chose one); check shots, narration and subtitles and edit the draft before exporting.

• No footage: return to Media and import videos.
• Insufficient footage: the rough cut may be shorter than the template.
• Narration failed: the rough cut is still created; add narration in AI Voice.
• If server processing has started, credits are handled according to the request status. Follow the message to retrieve the cut with the same choices.

Create a film summary video Copy link

Create a script and narration from film dialogue, then review the summary edit.

1. Create a Film summary project, import a film in Source and transcribe its speech.
2. Open Film summary; choose Summary duration, style and Narration voice. Preview the voice before continuing.
3. Read the dialogue and timestamp submission option, review the estimate and Pricing, then select Continue.
4. Review the resulting script; open the edit, preview picture and narration, then export the video.

• Session expired: sign in again before continuing.
• Narration failed: use Continue to retry as instructed; avoid a new request while an unfinished summary exists.
• Service interrupted: retry the current request. If it has reached the server, read the message before cancelling or creating a new version.

Import a film from your computer or a link Copy link

Add a film to a Film dubbing project and check the active source before creating dialogue.

1. Open a Film translation project and go to Source.
2. Select a local video or drag it into the import area. For a link, paste the address and use the source download button.
3. Watch the download list; check the name and duration of the current film.
4. Open Dialogue & Translation after the film has been added to the project.

• Download failed: check your connection and access to the link, then retry.
• Downloaded but not added: reopen the project and check that the downloaded video is still available. The download list contains link downloads only.
• Replacing the source does not delete dialogue from the previous film. Check that film and lines match before continuing; use a new project to start over.

Create dialogue and translate a film Copy link

Create dialogue from the film audio and translate it for dubbing.

1. Go to Dialogue & Translation after importing a film.
2. Select Transcribe dialogue if there is no dialogue, then watch the status and line count.
3. Select lines to translate or leave the selection empty to translate all lines, then use the translation button.
4. If the server translation dialog opens, read the estimate and current balance before confirming; you can choose Translate locally. Review the translation when complete.

• No source: return to Source and import a film. Translating without dialogue may queue transcription first.
• On failure, read the message; follow Install libraries to get started if a component is missing. Read and edit the machine translation before approving it.

Review and edit individual lines Copy link

Compare source dialogue with the translation, edit lines and listen again after changes.

1. Search or filter lines in Dialogue & Translation and select a line.
2. Listen to the source and read the translation; unlock a locked line before editing.
3. Edit the translation and select Save translation. Approve it when the content is correct.
4. After dubbing the whole film once, use Redo voice to update the edited line audio; listen again and lock the line if you want to keep it unchanged.

• A line without a translation cannot be approved. Locked lines cannot be edited or retranslated.
• If saving fails or the line changed elsewhere, reopen it and read the message before editing again. Changing a role or text does not update existing audio automatically.
• If a line is too long, shorten the translation, regenerate audio and listen to its ending.

Read dialogue from burned-in captions Copy link

Read source dialogue from burned-in Chinese captions when the film audio is hard to understand.

1. Import a film into a Film translation project that has no dialogue yet.
2. Go to Dialogue & Translation and select Read printed captions.
3. If the burned-in text component is missing, follow Install libraries to get started, restart and run the action again.
4. Watch caption reading; check the source text and timing of each line before translating.

• Dialogue creation does not run again when the project already has lines. Use a new project to extract dialogue another way.
• Blurred text or complex backgrounds may cause recognition errors; review and edit the translation before creating audio.

Assign roles, choose voices and create audio Copy link

Assign dialogue to the right roles and choose voices before dubbing the whole film.

1. In Dialogue & Translation, select lines, choose a role and use Assign role to selected lines.
2. Open Characters & Voices and select a role to assign a voice. Filter by gender and preview voices to choose pronunciation and delivery suited to the role.
3. Preview the voice and check that roles have voices and dialogue is translated.
4. Select Dub the whole film, watch progress and review the results for voiced lines, lines that do not fit and lines without audio.

• Voice not installed: install it in Integrated Library and restart.
• If lines are silent or too long, check their translations and role voices, edit and regenerate audio. Changing a voice requires dubbing again to replace existing audio.

Finish audio and subtitles Copy link

Check audio against the picture and finish subtitles before exporting.

1. Open Final Cut and play sections near the beginning, middle and end to compare dubbed audio with the picture.
2. Use the audio realignment command if dubbed clips were moved away from their lines. Adjust and listen to tracks in the audio panel.
3. Adjust subtitles and covered areas in the viewer.
4. Review the picture and open the export check panel to address remaining warnings.

• Hiding a picture track or muting an audio track affects both preview and export.
• Unlock the source picture before cutting or deleting it. Rebuilding the edit discards manual timeline changes; read the confirmation before accepting.

Export a finished film Copy link

Choose export settings and check the finished video and accompanying subtitles.

1. Open Export from the finished project; choose a preset or adjust picture settings.
2. Choose audio and subtitle output, then read the summary.
3. Set a name and destination and check the output path. Start exporting and watch its status.
4. When complete, open the exported video and check picture, audio, logo and subtitles near the beginning, middle and end. Check the separate subtitle file if selected.

• Export failed: read the message, check free space and write access to the destination, then retry.
• If an update is required, finish updating before export. When export completes, open the finished video to check it.

Find and change keyboard shortcuts Copy link

Find the current shortcuts and change command combinations to suit your workflow.

1. Press Ctrl+/ to open the shortcut list.
2. By default, F11 toggles full-screen HANAVI; Shift+F11 toggles the full-screen viewer. F1 opens the help dialog.
3. Open Settings with Ctrl+,, select shortcuts, click a command key cell and press a new combination. Esc cancels capture.
4. Use a command reset button or Reset all to default to restore defaults; check the save message.

• If a combination is taken or reserved for the system, choose another as instructed.
• If saving fails, retry to save the new keys. Check the list for current combinations after changing them.

Check credits and access Copy link

Check the balance, plan and credit usage for the current account.

1. Open the account button at the top right and select Overview.
2. Read the credit balance and current plan; check the Pro expiry date if present.
3. Review received and used credits and server translation minutes this month.
4. Before running a paid feature, read the in-app estimate and compare it with Pricing on hanavi.vn.

• Overview unavailable: check the connection and reopen it.
• Session expired: sign in again by email code and check the account. Check access and limits in Overview.

Buy credits or a plan Copy link

See the packages currently offered and track a purchase in Account.

1. Open Account and select Buy credits / plan; compare current prices with Pricing on hanavi.vn.
2. If purchasing is available, choose a package and read the order details, amount, transfer reference and payment deadline.
3. Scan the QR code or transfer using the exact order details. For automatic reconciliation, wait for the panel to update; if I have transferred is shown, select it after transferring.
4. Check the order status and Overview to confirm that credits or plan access have been received.

• If bank transfers are closed, check again later or use a valid issued code.
• Awaiting review: wait for the order to be approved, then check credits in Overview. If an order expires or transfer details differ, keep the transaction details and contact support.

Check credit history Copy link

Review credits received, spent and refunded against your work.

1. Open Account and select Credit history.
2. Read the time, transaction type and credit change on each row.
3. Compare purchases, AI usage or refunds with the work you performed and Overview.
4. If they do not match, record the time and transaction type for support.

• The table may be empty when there are no transactions.
• A table loading error does not remove credits; check the connection and reopen history to view it.

Enter a referral code Copy link

Enter a friend referral code or an issued gift code and check the account result.

1. Open Account and select Enter referral code.
2. Enter the issued code and select Apply.
3. For a friend code, the app returns to Overview after recording it and shows who referred you. Rewards are granted when the conditions are met; read the current reward conditions.
4. For a gift code, read the grant result and check Overview. To share your own code, find the referral code section in Overview.

• For an incorrect, used, expired or revoked code, read the message and check it with the issuer.
• Too many attempts: wait for the period shown by the app. If the session expires, sign in again before applying the code.

Fix missing libraries or installation failures Copy link

Resolve missing components or failed installation before retrying your task.

1. Read the missing component name and open Integrated Library.
2. Follow Install libraries to get started; on a failed card, read the reason and check the connection and free space.
3. Retry the failed card and watch until a result is shown.
4. Finish restarting as described in that article, then retry the blocked action.

• Queued: another component may be installing first; wait for your turn.
• If installation keeps failing, keep the message and component name for support; do not delete project data as a repair attempt.

Handle update failures or blocked export Copy link

Distinguish an update download failure from a required update before exporting.

1. Read the update dialog and check the connection after a download failure.
2. Select Try again. If Keep using this version is offered, use it to continue with the current version.
3. If a required update blocks Export, finish updating; continuing with the current version is unavailable in that state.
4. When ready, select Restart to update; wait for active export or dubbing work to finish if required.

• Repeated download failures: record the message and app version for support.
• Do not close the app during export or dubbing to force an update; follow the dialog status.

Handle audio preview or export failures Copy link

Read preview or export errors, check the source and retry deliberately.

1. Identify whether the failure is in audio creation, playback or video export; record the message.
2. For voice preview, check that the voice is installed and retry. If playback fails, check system volume and the generated audio.
3. If Final Cut cannot mix preview audio, play again to retry mixing; check muted tracks and whether sources are available.
4. For export failure, check the destination, write access, free space and media sources; reopen Export and retry. Open the finished file after completion.

• Send support the exact audio generation or playback error you see.
• For repeated failures, send reproduction steps and a screenshot with personal details hidden; check the name and timestamp of the newly exported video, then open it to review.

Send an error report and contact support Copy link

Choose how to report an error and provide steps that help support reproduce it.

1. When HANAVI encountered an error appears, open the details to inspect the cleaned report.
2. Choose Send for this report, Always send to save your preference for future reports, or Do not send.
3. In Settings, find Send error reports to HANAVI to change whether to ask, always send or never send.
4. For direct support, email info@hanatech.vn with the HANAVI version, Windows version, steps before the error and message; hide email addresses, codes and transaction details in screenshots.

• Automatic reports do not attach films, subtitles or dialogue.
• If sending fails because of the network, reports remain queued for a later retry. If an error occurs without the report dialog opening, send your steps and an error screenshot through the support contact section.