# Music|deepin-music|

## Overview

Music is a local music playing application with brand-new UI design and state-of-the-art playing experience featured with local music scanning and lyric sync functions, etc.

![main](fig/main1.png)

## Guide

You can run, close, and create a desktop shortcut for Music in the following ways.

### Run Music

1. Click the Launcher icon ![launcher_icon](../common/deepin_launcher.svg) in the Dock to enter the Launcher interface.
2. Locate Music ![music_icon_24](../common/music_icon24.svg) by scrolling mouse wheel or searching "music" in the Launcher interface.
3. Right-click the Music application icon and you can:
 - Click **Send to desktop** to create a desktop shortcut.
 - Click **Send to dock** to fix the application in the Dock.
 - Click **Add to startup** to add the application to startup and it will automatically run when the system starts up.

> ![notes](../common/notes.svg) Notes: If Music has been fixed in the Dock, you can also click ![music_icon24](../common/music_icon24.svg) in the Dock to run it.

### Minimize to System Tray

Music can be minimized to the system tray.

- Click ![icon_menu](../common/icon_menu.svg) > **Settings** on the music interface and check **Minimize to system tray**. Music will be minimized directly to the system tray each time you close the main window. 
- Click ![close_icon](../common/close.svg) on the Music interface to close the main window, select **Minimize to system tray** and click **Confirm**.

  > ![notes](../common/notes.svg) Notes: Check **Minimize to system tray** and **Do not ask again** and the pop-up window will no longer be displayed.

Right-click the Music application icon in the tray and you can perform the following operations:

 - Click **Play/Pause** to play/pause the song. 
 - Click **Previous** to play the previous song. 
 - Click **Next** to play the next song. 
 - Click **Exit** to exit Music.

### Exit Music

- On the Music interface, click ![close_icon](../common/close.svg) and select **Exit** to exit Music or click ![close](../common/close.svg)to exit music directly if you have checked the **Exit** option in the **Close Main Window** option.  
- Right-click the Music application icon ![music_icon24](../common/music_icon24.svg) in the Dock and select **Close All** to exit Music.
- Right-click ![music_icon24](../common/music_icon24.svg) in the system tray and select **Exit** to exit Music. 

### View Shortcuts

On the Music interface, press **Ctrl** + **Shift** + **?**  to view the shortcuts. Proficiency in shortcuts will greatly improve your efficiency.

![0|view](fig/hotkey.png)

## Main Interface

On the main interface, you can choose from regular options, check view playlist, and get song info.

![1|main](fig/main.png)

             1
             Search box
             You can search music quickly by search box.

             2
             Add music
             You can add music to the playlist.

             3
             Main menu
             You can add playlist, add music, set options, view manual and about information, and exit the application via main menu.

             4
             Sort options
             You can sort the list by different types of order including time added, title, artist, or album name.

             5
             Previous/Next
             Click to switch to Previous/Next music.

             6
             Play/Pause button
             Click to Play/Pause music.

             7
             Play box
             Show the name of the song being played, the cover, and the artist name.

             8
             Favorite
             Click to add music to my favorites and click again to unfavorite it.

             9
             Lyrics
             Click it to switch to the lyrics interface and click it again to exit the lyrics interface.

             10
             Play mode
             Click it to switch to the play mode, including list loop, single loop, and shuffle.

             11
             Volume
             Click it and drag the volume bar to adjust the volume.

             12
             Play Queue
             Click it to show/hide the playlist.

## Common Operations

You can add, delete, and view info of the local music in Music in the following ways.

> ![notes](../common/notes.svg) Notes: The actual functions supported may differ according to the decoding method adopted.  Please refer to the interface.

### Add Music

On the Music interface, you can add music in the following ways: 
- Click the ![icon_menu](../common/add1.svg) icon on the title bar.
- Click ![icon_menu](../common/icon_menu.svg)> **Add music** to add music files to the playlist.
- Drag the music file/folder to the Music interface.

> ![notes](../common/notes.svg) Notes: If there is no music file in Music, you can also click **Add Music**,  **Open Folder** or **Scan** to add music. Otherwise, you can also right-click the music repository or playlist to choose **Add music** to add your music .

### Search Music

1. In the search box on top of the Music interface, you can click ![search](../common/search.svg) to enter keywords.

2. Press the **Enter** key on the keyboard to conduct search.

3. Click ![0|close](../common/close.svg) or delete the entered information in the search box to clear the current information or cancel the search.

### Play Music

You can play music in the following ways:

- Select a song in the playlist, and double-click or right-click it to select **Play** to play the music.
- Select a list under the playlist in the left navigation bar. Right-click and select **Play** to play all the songs in the list according to the current order.
- Click **Play All** to play all the songs in the current list according to the current order. 

> ![tips](../common/tips.svg) Tips: On the Music interface, click ![play_normal](../common/play_normal.svg) to play the selected music. Click ![suspend_normal](../common/suspend_normal.svg) to pause the play. Click ![last_normal](../common/last_normal.svg) or ![next_normal](../common/next_normal.svg) to switch to the previous or the next song according to the current play mode.

### Add Music to My Favorites

On the Music interface, click ![collect](../common/collect.svg) to add music to My Favorites.

The prompt information **Successfully added to "My favorites"** pops up and the music is added to **My Favorites** list.

> ![tips](../common/tips.svg) Tips: You can also right-click the music, and select **Add to playlist** > **My favorites** to add the music to **My Favorites** list.

### View Lyrics

On the Music interface, you can:

- Click ![lyric_normal](../common/lyric_normal.svg) to switch to the lyrics interface. Click it again to fold the lyrics interface.

- Click ![music](../common/music.svg)to switch to the lyrics interface. Click it again to fold the lyrics interface.

> ![notes](../common/notes.svg) Notes:  If the music being played has a cover picture,  ![music](../common/music.svg)will be displayed as the cover picture. Click it to switch to the lyrics interface.

### Adjust Play Mode

On the Music interface, click ![single](../common/single_tune_circulation_normal.svg) ,  ![cross_cycling_normal](../common/cross_cycling_normal.svg) or ![sequential_loop_normal](../common/sequential_loop_normal.svg) to adjust the play mode.

![single](../common/single_tune_circulation_normal.svg): Single loop

![cross_cycling_normal](../common/cross_cycling_normal.svg): Shuffle

![sequential_loop_normal](../common/sequential_loop_normal.svg): List loop

### Display in File Manager

1. On the Music interface, right-click the music.
2. Click **Display in file manager** and you can view the music file in File Manager.

![0|infile](fig/infile.png)

### Delete Music

On the Music interface, right-click the music and you can:

- Click **Remove from playlist** to remove the music from the playlist, but the music file will still be saved on the local disk.
- Click **Delete from local disk** to remove the music both from the playlist and the local disk. 

![0|remove](fig/remove.png)

### Select Encoding

For music with garbled characters, you can make it display normally by switching the encoding methods.

1. On the Music interface, right-click the music.
2. Click **Encoding**, and select the encoding as needed.

![0|encoding](fig/encoding.png)

### View Music Info

1. On the Music interface, right-click the music file in the playlist.
2. Click **Song info** to view the music title, artist, album, type, size, duration, path, and other information.

![0|info](fig/info.png)

## Playlist Management

On the Music interface, you can create, delete, and rename playlist. You can also add music to the playlist.

> ![notes](../common/notes.svg) Notes: **All music** and **My Favorites** are set as default playlists and cannot be deleted. Custom playlists are subsets of the **All Music** playlist. **My Favorites** playlist can be managed directly or through the Favorite icon on the main interface.

### Create New Playlist

1.  On the Music interface, click ![add](../common/add.svg) right to the **Playlists**, or click ![menu](../common/icon_menu.svg)> **Add playlist**.
2.  Enter the name of the playlist.
3.  Press the **Enter** key on keyboard.

>![tips](../common/tips.svg) Tips: You can also create a new playlist by right-clicking a song and then choosing **Add to > Create new playlist**.

0|addlist

### Rename Playlist

1.  Select a playlist from **Playlists**.
2.  Right-click and select **Rename**.
3.  Enter the name of the playlist, and press the **Enter** key on the keyboard to save it.

![0|renamelist](fig/rename.png)

### Add Music to Playlist

1. On the Music interface, select the music you want to add.
2. Right-click and select **Add to** to add the music to the selected playlist.

> ![tips](../common/tips.svg)Tips: You can drag the local music to a specified playlist to add the music into the current playlist and **All Music** playlist. 

![0|addtolist](fig/addtolist.png)

### Remove Music from Playlist

1. Select a playlist from **Playlists**, and select the music you want to remove from it.
2. Right-click and select **Remove from playlist** to remove the music from the playlist.

![0|remove](fig/removefromlist.png)

### Delete Playlist

1. Select a playlist from **Playlists**. 
2. Right-click the playlist to be deleted, and select **Delete**.
3. In the pop-up window, select **Delete** to confirm the operation.

![0|deletelist](fig/deletelist.png)

## Main Menu

In the main menu, you can [Add Music](#Add Music), create new playlists, set the equalizer and the options, switch window themes, view help manual, and get more information about Music.

### Equalizer

You can set your favorite music mode, such as classical, rock, and so on. 

1. Click ![menu](../common/icon_menu.svg) on the Music interface.
2. Select **Equalizer**.
3. You can switch on equalizer, customize **Preamplifier** values and frequencies, and click **Save**; or select a music mode from the drop-down list which will be automatically saved by the system.
4. Click **Restore Defaults** to restore the default settings.

![equalizer](fig/equalizer.png)

### Settings

You can set the basic information and shortcuts in settings.

#### Basic Settings

1. Click ![menu](../common/icon_menu.svg) on the Music interface.
2. Select **Settings** > **Basic**.
    - In the option **Play**, you can:
        - Check the **Autoplay** box, and the music will be played automatically when Music runs.
        - Check the **Remember playback position** box, and the music will be played automatically from the last position played when Music runs.
        - Check the **Enable fade in/out** box, and the music will fade in and out when Music runs.
    - In the option **Close Main Window**, you can:
        - Select **Minimize to system tray** to close the main window, and hide Music to system tray.
        - Select **Exit** to close the main window, and exit Music. 
        - Select **Ask me always** to prompt system notification, and confirm whether to exit Music when the main window is closed.

#### Shortcuts

1. Click ![menu](../common/icon_menu.svg) on the Music interface.
2. Select **Settings** > **Shortcuts** to view the shortcuts.
3. You can select and re-enter shortcut keys to customize your choice.

### Theme

The window theme provides three theme types, namely Light Theme, Dark Theme, and System Theme.

1. Click ![menu](../common/icon_menu.svg) on the Music interface.
2. Click **Theme** to select one theme.

### Help

1. Click ![menu](../common/icon_menu.svg) on the Music interface.
2. Click **Help** to view the manual of Music.

### About

1. Click ![menu](../common/icon_menu.svg) on the Music interface.
2. Click **About** to view the version and introduction of Music.

### Exit

1. Click ![menu](../common/icon_menu.svg) on the Music interface.
2. Click **Exit** to exit Music.