*! version 1.14 19May2021
help for imusic

Title

imusic -- Find music and enjoy while working on Stata.

Syntax

imusic
[keywords,
list(#)
platform
browse
stop
kind
link
stop
markdown
autoplay
ndescription]

Description

imusic let you search what you would like to listen and play it online or locally in Stata without affecting your work.

This gadget has been tested for China users. The songs mainly come from two Chinese online music platforms:
one is Tencent music (https://y.qq.com), and the other is Netease music (https://music.163.com/).
For users outside China, we haven't tested it yet. If you encounter any problems in using imusic,
or you want to add new music platform to imusic, please email us.

Options

list(#) Display # results in result window. The default is 1.

platform(string) Specify which music platform to be searched.

Specify p(t) or p(T) means Tencent music (https://y.qq.com).

Specify p(n) or p(N) means Netease music (https://music.163.com/).

Specify p(l) or p(L) means your local music folder.
In this case, you should execute global songpath "D:\music" before using imusic,
where "D:\music" should be replaced with your own forlder path.

browse Open the link directly in your web browser. Only for p(t/T) or p(n/N).

stop Stop the music if p(l/L). Only for Windows(groove.exe or QQMusic.exe)

kind Specify which type you're searching, default is single.

single=1; album=10; songlist=1000; Radio=1009; MV=1014

MV is not available for Netease; songlist & radio is not available for Tencent

link Show link.

nl Do not show lyrics.

markdown Show link in markdown format.

autoplay Browse a website that can autoplay music.

Isn't available when search non-single on Tencent

ndescription Do not show description.

Examples

Show me a song randomly

. imusic

List one song with keyword "海阔天空"

. imusic 海阔天空

List 10 songs with keyword "see you again"

. imusic see you again, l(10)

List 5 songs with keyword "see you again" in Markdown format

. imusic see you again, l(5) m

List 5 songs with keyword "梁祝" from platform Tencent (https://music.163.com/)

. imusic 梁祝, l(5) p(t)

Shortcoming

platform(l) is not available when Mac system or default music player is Netease.

It'll take some time when you want to listen to a random song.

Acknowledgement

Codes from sxpose by Prof. N.J. Cox have been incorporated.

Author

Jingyi, Zheng (郑静怡) Lingnan College, Sun Yat-Sen University, China.

E-mail: zhengjy57@sysu.edu.cn

Yujun, Lian* (连玉君) Lingnan College, Sun Yat-Sen University, China.

E-mail: arlionn@163.com

Blog: lianxh.cn

Support

Please visit https://gitee.com/arlionn/imusic.

To uninstall, you can use
ado uninstall imusic