TiLiA allows users to annotate media files primarily through timelines of various types. Each one provides different tools and enables specific annotations and visualizations. Currently, there are six types of timelines, but many more are planned.
Here are some examples TiLiA visualizations:
- Formal analysis of the Piano Sonata in C Major, K.284:
Instructions can be found at the website.
- 6 kinds of timelines
- AudioWave: visualize audio files through bars that represent changes in amplitude
- Beat: beat and measure markers with support to numbering
- Harmony: Roman numeral and chord symbol labels using a specialized font, including proper display of inversion numerals, quality symbols and applied chords
- Hierarchy: nested and leveled units organized in arbitrally complex hierarchical structures
- Marker: simple, labeled markers to indicate discrete events
- PDF: visualize PDF files synced to playback
- Score: visualize music scores in custom, to-scale notation or conventional engraving
- Controlling playback by clicking on timeline units
- Multiple attributes linked to each timeline unit
- Local audio and video support
- YouTube stream support
- Customizable metadata can be attached to files
- Creation of multiple timelines
- Timeline edition during playback
- Toggling of timeline visibility
- Export of audio segments based on analysis
- Import timeline data from CSV files
There are many more features that we would like to implement than can be listed here, including:
- New kinds of timelines
- Range: displays units with an extension but not tied to hierarchical structures
- TiLiA explorer: allows filtered searches through timeline components across multiple TiLiA files
- Font and GUI color customization
- Video segments export
- Automatic beat detection for audio
The TiLiA desktop app is supported by an online platform that allows .tla files to be stored, visualized, shared and queried.
Visit TiLiA's download page for the latest release.
Before you start, you will need:
- Python 3.11 or later. You can get it at the Python website.
pipto install dependencies.- Git to clone the TiLiA repository. You can get it at the Git website.
Go to the desired directory and clone TiLiA with:
git clone https://github.com/TimeLineAnnotator/desktop.git tilia-desktop
Change directory to the cloned repository:
cd tilia-desktop
Note: We recommend using a virtual environment for the next steps.
Install the dependencies using pip:
pip install -e .
Install PyInstaller with:
pip install pyinstaller
Run PyInstaller using the settings in tilia.spec:
pyinstaller tilia.spec
The executable will be created in the 'dist' folder inside the project directory.
You can follow the instructions in the previous sections to clone the repository and install dependencies.
Use this command to run TiLiA in CLI mode:
python -m tilia.main --user-interface cli
See Contributing.
TiLiA is licensed under the GNU General Public License (version 3). The complete license can be found here.
The TiLiA interface was greatly influenced by Brent Yorgason's Audio Timeliner. We thank the author for the development and free distribution of his software.