.. _tutorial_basic_use:

3. TheorChem2Blender - Basic use
=================================

Overview
---------
TheorChem2Blender is a program that has 5 tabs. Which tabs to modify depend on the type of 3D file the user wants to create. For the simplest use of the program, you only need to specify the input, and convert it as output. The default output format is `glb`.
Below is an example using the `input_examples/` folder that comes with the program on how to convert a `com` input file to a `glb` 3D file.

Input tab
----------
1. Leave `.com` as the input file
2. Click on `set` to select the input name

.. image:: /_static/images/tutorial3_step1.png
    :alt: Selecting .com input, steps 1 and 2
    :width: 500px

3. The `input_examples/` folder was opened by default. Select `com_files/`

.. image:: /_static/images/tutorial3_step2.png
    :alt: Selecting .com input, step 3
    :width: 500px

4. Among the available folder options choose `organic/`

.. image:: /_static/images/tutorial3_step3.png
    :alt: Selecting .com input, step 4
    :width: 500px

5. Choose `dimethyl_dithionate.com` to follow this example

.. image:: /_static/images/tutorial3_step4.png
    :alt: Selecting .com input, step 5
    :width: 500px

6. Notice how the name is now stored in the `Input name(s)` space
7. Click on the `Convert!` tab

.. image:: /_static/images/tutorial3_step5.png
    :alt: Selecting .com input, step 5
    :width: 500px

Convert! tab
-------------

8. Click on `Convert!`
9. Your file will appear by default in the `output/` folder.

.. image:: /_static/images/tutorial3_step6.png
    :alt: Selecting .com input, step 6
    :width: 500px

.. note::

   🎥 To see a video recording of this walkthrough, visit the following link:  
   `Watch on YouTube <https://youtu.be/XUTL1noQ8Y0>`_


:ref:`Previous: (2) From Molecular Dynamics to Blender (General) <tutorial_from_md>`
:ref:`Next: (4) Highlighting atoms and bonds <tutorial_customization>`

----

:doc:`← Back to Tutorials Home <tutorial>`