# Install and Quick Start
{% hint style="info" %}
Using the asset is a matter of a few clicks (import -> add components -> press play), but to better understand everything please have a look at the following pages, so that you can start even faster and in the right direction.
{% endhint %}
### 1. Import Text Animator for Unity
As the very first step, you need to import Text Animator for Unity in your project.
#### Compatibility Check
**The asset works with the following UI and Unity versions**:
* **Text Mesh Pro** (Unity 2022.3 and up)
* **UI Toolkit** ([Unity 6.3 and up](#user-content-fn-1)[^1]).
It also supports the new Unity input system (and the legacy one, too).
#### Import the Package
Once your project is set up correctly, you can import Text Animator from the Package Manager (Asset Store tab).
After a successful installation, the **welcome window** will show up and Text Animator is ready to animate your texts!
{% hint style="info" %}
In case the about window doesn't show up, or if you want to see it later, you can access it anytime from the Menu at `Tools/Febucci/TextAnimator/About Window`
{% endhint %}
A part of the Welcome Window, which shows after import
### Import the Databases
Make sure you have imported the default effects and actions databases. You should see all their files in the `Assets/Plugins/Febucci/Text Animator for Unity` folders
{% hint style="info" %}
In case you do not see default data, or if you want to reset / re-install them, you can always go on the About Window and click "Install Built In Effects" ( or reset them )
{% endhint %}
{% hint style="success" icon="thumbs-up" %}
This way, you can update the asset without worrying that the effects you have edited will be overwritten. Yay!
{% endhint %}
### 2. Example Scenes
You can learn about most Text Animator features directly from the inspector, and see how we've set up things and their direct result from the example scenes.
Make sure you import the **Samples** packages and scenes either from the About window, or the package manager.
{% columns %}
{% column %}
you can import the samples scenes from the about window
{% endcolumn %}
{% column %}
you can also import the samples scenes from the Package Manager
{% endcolumn %}
{% endcolumns %}
You can start from the scene called "**00 - Welcome**" and the continue with each feature and use case!
{% hint style="success" icon="thumbs-up" %}
You can delete example scenes once you do not need them, and can re-import again anytime you want.
{% endhint %}
{% embed url="" %}
## 3. Animating your first texts
You can get your texts running in a few clicks!
{% tabs %}
{% tab title="UI Toolkit" %}
*P.S. Assuming you already know* [*how to use UI Toolkit*](https://docs.unity3d.com/Documentation/Manual/UIElements.html) *and what it does.*
#### From the UI Builder
* Go to Library -> Project
* Drag "AnimatedLabel" from "Custom Controls/Febucci/Text Animator for Unity" in your hierarchy!
{% hint style="info" %}
We are working to make sure you can animate built in Labels and Buttons from UI toolkit directly! *(Unity 6.3 and up.)* Stay updated!
{% endhint %}
Your .uxml should look like this:
#### Via Code
You can create an instance of the "Febucci.TextAnimatorForUnity.AnimatedLabel" class and add it to your UI document, like this:
```csharp
using UnityEngine;
using UnityEngine.UIElements;
using Febucci.TextAnimatorForUnity; // <- import Text Animator's namespace
public class ExampleScript : MonoBehaviour
{
[SerializeField] UIDocument document;
void Start()
{
var container = document.rootVisualElement.contentContainer;
var animatedLabel = new AnimatedLabel(); // <- create an animated label
container.Add(animatedLabel); // <- add it to the content container
// [..]
animatedLabel.SetText("hello"); // <- set the text
}
}
```
{% endtab %}
{% tab title="Text Mesh Pro" %}
*P.S. Assuming you already know* [*how to use Text Mesh Pro*](https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/TextMeshPro/index.html) *and how it works.*
Add a Text Animator - Text Mesh Pro component on the same GameObject that has a TextMeshPro component (either UI or world space!):
Your inspector should look like this:
{% endtab %}
{% endtabs %}
{% hint style="success" %}
You can read [setting-up-texts](https://docs.febucci.com/text-animator-unity/effects/setting-up-texts "mention") for more details and suggestions!
{% endhint %}
### Writing effects in your text
One way to adding effects in your text is using rich text tags, like this: “`I'm freezing`”, where "shake" is an ID for a built-in effect.
* Try writing a text by experimenting with the following tags: `` `` `` ``, like “`I'm joking hehe now I'm scared`”, then enter Unity’s Play mode.
{% embed url="" %}
{% hint style="success" %}
Your text is animating letters based on the effects you’ve written!
{% endhint %}
***
Have fun animating your texts! You can proceed to the next page for a more in-depth look on all the asset's features.
[^1]: Other versions are under consideration/testing! (as they need some important workarounds.) Stay tuned!
