The User Interface

In this section, we'll go through each screen in Moose (there's really only one, with a bunch of modals), and describe what they do and what you can do with them.

Click on the image to expand it. (It helps to open in a new tab, but markdown doesn't support that yet)

Table of Contents:

• Main Interface
• Settings Menu
  • Genre List
  • Logging
  • Files
  • API Config

Main Interface

1. File Menu:
   This menu is a standard File menu, it gives you the options to quit (⌘Q), save (⌘S or ⇧⌘S), and open (⌘O). Check out The Basics to see how to save and open files.

2. View Menu:
   This menu doesn't have much right now, but it gives you the ability to refresh the UI, which wipes everything out to start over. I might add a couple themes/color changes in this menu, so stay tuned for that.

3. Actions Menu:
   This menu allows you to perform actions on highlighted tracks in the table. These actions include (but are not limited to) adding cover art, adding track/disk numbers, and the main Autotagging feature. For more information on Autotagging, click here for the wiki on that feature.
   This menu also include the Audit and Format Filenames actions. Check out the Audit article here and the Filename Formatting Service option here.

4. Help Menu:
   This menu gives you some helpful information about Moose, including the About option, which will give you the version and copyright information. It also has a command prompt feature (not fully fleshed out yet...) for quick automated processes, also accessible by pressing ⇧⌘C. Lastly, you can access the Settings menu from this menu, or by pressing ⌘,.

5. Clear All Button:
   This button clears all the tracks you currently have in the table. This currently does not ask for confirmation before clearing all the tracks, an upcoming release will have a dialog before removing everything.

6. Save All Button:
   A button to save all tracks currently in the table. On successful saves, the icon to the far right will turn from the blue edit symbol to the green saved symbol.

7. Open All Button:
   Open all the files currently in the table using whatever default music program you have selected. In my case, it's Apple Music (FKA iTunes).

8. Track Table:
   The main table where your tracks will be. (Note: This will only show mp3 files!) On loading the tracks into the table, the table will be populated with whatever information the mp3 files already have. Check out The Basics to see how to interact with the tracks in the table, including editing, navigation through the table, and more.

9. Status Log:
   This is a logging window that shows you the actions you have performed on the tracks in the table, as well as other interactions with the app.
   (Note: Logging isn't at the stage I'd like it to be, a future release will have better event logging in this window)

10. Multiple Track Editor:
    A basic editor used to edit multiple track's information. Check out the Multiple Track Editor section to learn more about this.

---

Settings Menu

Accessed by going to Help -> Settings or by using the ⌘, (comma) shortcut.

Genre List

   1. Genre Textfield:
       The input for adding a new genre to the list.

   2. Add/Submit Button:
       A button to add a new genre. When you click in the list to
       select an item, the text on the button will change from "Add"
       to "Submit" so you can submit the change to that specific
       genre.

   3. Delete Button:
       Button that allows you to delete a genre. Click on a genre in
       the list to enable the button and allow you to delete it.

   4. Cancel Button:
       Cancels what you're doing to that current genre.

   5. Genre List:
       The list of all of your genres.
       Note: New genres that you've added and not saved yet will
       show up as bold and italicized, as shown here.

   6. Restore Defaults Button:
       A button that allows you to restore ALL of your settings to the default values.
       Note: This will default everything, including your API key and CSE ids in the album art finder.

   7. Save Settings Button:
       A button that allows you to save the settings you have edited. Any settings you've changed will show as green.

Logging

   1. Enhanced Debugging Checkbox:
       An option to enable enhanced debugging.
       Note: Not implemented fully yet.

   2. Developer Mode:
       An option to enable dev mode.
       Note: Not implemented fully yet.

   3. Open Event Log Button:
       Opens the event log.

   4. Clear Event Log Button:
       Clears the event log after asking for confirmation.

   5. Open Error Log Button:
       Opens the error log.

   6. Clear Error Log Button:
       Clears the error log after asking for confirmation.

Files

   1. Browse Button:
       Click this button to open a file choose to set your library
       location.

   2. Library Location:
       The current location of your music library. Will not show
       if it's not set.

API Config

   1. Custom Search Engine ID:
       The id of your CSE.

   2. API Key:
       Your unique API key for your CSE.

   3. Date last used:
       The date that your CSE was last used.

   4. Times used today:
       Times that your CSE was used today out of the maximum 100.

   5. Preferred Cover Art Size:
       The size you'd like your cover art to be.