1.. This is part of the Zrythm Manual.
2   Copyright (C) 2020 Alexandros Theodotou <alex at zrythm dot org>
3   See the file index.rst for copying conditions.
4
5.. _main-toolbar:
6
7Main Toolbar
8============
9
10The main toolbar contains global actions, such as saving
11and loading a project or opening the preferences window.
12
13.. image:: /_static/img/main-toolbar.png
14   :align: center
15
16About Dialog
17------------
18
19Clicking the Zrythm icon will show the About dialog, which
20contains information about authors and copyright.
21
22.. image:: /_static/img/about-dialog.png
23   :align: center
24
25Global Menus
26------------
27Zrythm has the following global menus at the top of its
28interface.
29
30Edit Menu
31~~~~~~~~~
32The Edit menu has various buttons and controls that
33are used often during editing and arranging.
34
35The :ref:`editing` chapter explains these controls
36in detail.
37
38Project Menu
39~~~~~~~~~~~~
40The Project menu contains various project-related
41actions such as saving, loading and exporting MIDI
42or audio.
43
44Project Management
45++++++++++++++++++
46New Project
47  Create a new project.
48Save
49  Save the current project at its current location.
50Save As
51  Save the current project at a new location.
52Load
53  Load a project.
54
55Export
56++++++
57Export As
58  Export the project as audio or MIDI. See
59  :ref:`export-audio-and-midi` for more details.
60Export Graph
61  Export the routing graph as an image or .dot graph.
62  See :ref:`export-routing-graph` for more details.
63
64.. seealso:: For more information about projects, see
65   the :ref:`projects` chapter.
66
67View Menu
68~~~~~~~~~
69The View menu contains controls to change the appearance of
70Zrythm and its various areas, such as zooming.
71
72Zoom
73++++
74Zoom In
75  Zooms in.
76Zoom Out
77  Zooms out.
78Original Size
79  Zooms back to the default zoom level.
80Best Fit
81  Zooms in or out as much as required to show all of
82  the events in the timeline.
83
84Visibility Toggles
85++++++++++++++++++
86Toggle Left/Right/Bottom Panels
87  Toggles the panel's visibility.
88Toggle Timeline Visibility
89  Toggles the timeline's visibility.
90
91Help Menu
92~~~~~~~~~
93The Help menu contains links for reporting bugs,
94donating, chatting and other useful links.
95
96Chat
97  Join the Zrythm chatroom on Matrix.
98Manual
99  View the user manual.
100News
101  Show the latest changelog.
102Keyboard Shortcuts
103  Show all the available keyboard shortcuts.
104Donate
105  Donate to Zrythm through LiberaPay.
106Report a Bug
107  Opens the page to report a new bug.
108
109Additional Controls
110-------------------
111The main toolbar also contains the following widgets.
112
113.. image:: /_static/img/main-toolbar-right-side.png
114   :align: center
115
116There are the following buttons next to the name of
117the current project.
118
119Scripting Interface
120  Shows the scripting interface.
121
122  .. seealso:: See the :ref:`scripting` section for
123     more information.
124Log Viewer
125  Displays the log, which gets updated real-time.
126Preferences
127  Shows the preferences dialog.
128
129  .. seealso:: See the :ref:`preferences` section for
130     more information.
131MIDI In
132  The MIDI In widget shows the :term:`MIDI` activity
133  of auto-connected MIDI devices and the live
134  waveform display shows the audio waveform from the
135  master output.
136