{"id":13858853,"url":"https://github.com/deepakjois/dhun","last_synced_at":"2025-07-14T01:31:53.988Z","repository":{"id":744144,"uuid":"395570","full_name":"deepakjois/dhun","owner":"deepakjois","description":"Minimalist Music Player for OS X","archived":true,"fork":false,"pushed_at":"2010-06-14T23:43:12.000Z","size":215,"stargazers_count":56,"open_issues_count":4,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-07-02T21:33:25.977Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deepakjois.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2009-12-04T17:10:40.000Z","updated_at":"2023-01-28T17:17:58.000Z","dependencies_parsed_at":"2022-08-16T10:45:26.954Z","dependency_job_id":null,"html_url":"https://github.com/deepakjois/dhun","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/deepakjois/dhun","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepakjois%2Fdhun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepakjois%2Fdhun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepakjois%2Fdhun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepakjois%2Fdhun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deepakjois","download_url":"https://codeload.github.com/deepakjois/dhun/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepakjois%2Fdhun/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265231095,"owners_count":23731521,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-05T03:02:22.994Z","updated_at":"2025-07-14T01:31:53.718Z","avatar_url":"https://github.com/deepakjois.png","language":"Ruby","readme":"## Introduction\n\n\u003e A dhun (Hindi: धुन; literally \"tune\") is a light instrumental piece in the\n\u003e Hindustani classical music of North India.\n\u003e\n\u003e Source : [Wikipedia](http://en.wikipedia.org/wiki/Dhun)\n\nDhun is a minimalist commandline music player for OS X.\n\nIt uses Spotlight to search for audio files on your computer and play them.\n\n## Quickstart\n\n### Installing Dhun\n\nRun the following commands to install Dhun. This will download the latest gem\nfrom [http://gemcutter.org](http://gemcutter.org), compile the extensions and\nput the binaries in the right place. You will need to have XCode installed for\nthe `gem` command to compile the native extensions.\n\n    $ gem sources -a http://gemcutter.org\n    $ gem install dhun\n    \nOr to install the bleeding edge, git pull from the repository and run:\n\n    $ sudo rake gem install\n\nFor notifications, you will need [Growl](http://growl.info) installed along\nwith the [growlnotify](http://growl.info/documentation/growlnotify.php) tool\nthat comes with Growl (but needs to be installed separately).\n\n### Starting Dhun\n\n    $ dhun start_server\n    Starting Dhun\n\nthis runs the Dhun server as a daemon by default. to not run it as a daemon:\n\n    $ dhun start_server --foreground\nor\n    $ dhun start_server -f\n\nSee `dhun help start_server for more information`\n\n### Querying for files\n\nDhun uses Spotlight to query for music files. Just specify a keyword, and Dhun\nwill look for files matching that keyword and start playing them.\n\nYou can also query the Spotlight database before playing the files, with the \n`query` command.\n\n    $ dhun query deadmau5\n\n    Querying: deadmau5 | 6 Results\n    1 : /Volumes/Storage/Music/Grand.Theft.Auto.IV-Radio.Station.Rips-AiTB/Electro-Choc/03 One + One - No Pressure (Deadmau5 Remix).mp3\n    2 : /Volumes/Storage/Music/Grand.Theft.Auto.IV-Radio.Station.Rips-AiTB/Electro-Choc/09 Chris Lake vs. Deadmau5 - I Thought Inside Out (Original Mix).mp3\n    3 : Deadmau5 - Alone With You\n    4 : Deadmau5 - Arguru (EDX's 5un5hine Remix)\n    5 : Deadmau5 - Bye Friend\n    6 : Deadmau5 - Clockwork\n\nyou can query based on certain filters such as artist,albums, title, genre and file.\n\n    $ dhun query --artist=\"Paul van Dyk\" --genre=trance --file 'Paul' --title in\n\n    Querying: [nil] | artist:Paul van Dyk title:in genre:trance file:Paul\n    3 Results\n    1 : Paul van Dyk - Talk In Grey\n    2 : Paul van Dyk - In Circles\n    3 : Paul van Dyk - In Between\n\nYOu can mix filters with regular queries as well.\n\n    $ dhun query paul --title=haunted\n\n    Querying: paul | title:haunted\n    1 Results\n    1 : Paul van Dyk - Haunted\n\nYou can also pass in multiple regular expressions too. they just need to be seperated by commas (,)\n\n    $ dhun query paul,trance\n\n    Querying: paul,trance | 13 Results\n    1 : Paul van Dyk - Volume (Productions)\n    2 : Paul van Dyk - Volume (Remixes Part 1)\n    3 : Paul van Dyk - Volume (Remixes Part 2)\n    4 : Paul van Dyk - Complicated (Feat. Ashley Tomberlin)\n    5 : Paul van Dyk - Haunted\n    6 : Paul van Dyk - White Lies (Feat. Jessica Sutta)\n    7 : Paul van Dyk - Sabotage\n    8 : Paul van Dyk - Get Back (Feat. Ashley Tomberlin)\n    9 : Paul van Dyk - Far Away\n    10 : Paul van Dyk - Another Sunday\n    11 : Paul van Dyk - Talk In Grey\n    12 : Paul van Dyk - In Circles\n    13 : Paul van Dyk - In Between\n\nNow lets put it all together and go crazy.\n\n    $ dhun query 'paul van',dyk --genre=trance --title=haunted\n\n    Querying: paul van,dyk | title:haunted genre:trance\n    1 Results\n    1 : Paul van Dyk - Haunted\n\n### Playing Files\n\nTo play the files, first enqueue the songs.\n\n    $ dhun play paul,trance\n\nthis can also be done by\n\n    $ dhun enqueue paul,trance\n\n    Querying: paul,trance | 13 Results\n    1 : Paul van Dyk - Volume (Productions)\n    2 : Paul van Dyk - Volume (Remixes Part 1)\n    3 : Paul van Dyk - Volume (Remixes Part 2)\n    4 : Paul van Dyk - Complicated (Feat. Ashley Tomberlin)\n    5 : Paul van Dyk - Haunted\n    6 : Paul van Dyk - White Lies (Feat. Jessica Sutta)\n    7 : Paul van Dyk - Sabotage\n    8 : Paul van Dyk - Get Back (Feat. Ashley Tomberlin)\n    9 : Paul van Dyk - Far Away\n    10 : Paul van Dyk - Another Sunday\n    11 : Paul van Dyk - Talk In Grey\n    12 : Paul van Dyk - In Circles\n    13 : Paul van Dyk - In Between\n    Enter index to queue: \n\nIt will prompt you to enter the index of the songs you want queued.(numbers on the left side)\nYou can enter them separated by commas(1,2,3,4) or spaces(1 2 3 4) or a single song if you like.\nIf you leave the prompt blank and enter, it will queue ALL the resulting songs.\n\n    Enter index to queue 4 5\n    selected:\n    1 : Paul van Dyk - Complicated (Feat. Ashley Tomberlin)\n    2 : Paul van Dyk - Haunted\n    2 files queued\n\nOnce queued, the songs will begin playing. You can continue to enqueue more songs using `enqueue` command.\n    \n### Controlling Playback\n\nStarting Playback(needs to have songs in queue)\n\n    $ dhun play\n    resuming playback\n    \nStopping playback.\n\n    $ dhun stop\n    Dhun has stopped\n\nPausing playback.\n\n    $ dhun pause\n    Dhun is paused at /Users/deepak/Dropbox/shared/music/Coke Studio/Jo-Meray.mp3\n\nResuming playback.\n\n    $ dhun resume\n    Dhun is playing /Users/deepak/Dropbox/shared/music/Coke Studio/Jo-Meray.mp3\n\nSkipping to next file\n\n    $ dhun next\n    Dhun is playing /Users/deepak/Music/iTunes/iTunes Media/Music/Edward Sharpe \u0026 The Magnetic Zeros/Here Comes/03 Carries On.mp3\n\nYou can use a numeric argument to specify the number of tracks to skip ahead,\nlike `dhun next 2`.\n\nSkipping to previous file in history.\n\n    $ dhun prev \n    Dhun is playing /Users/deepak/Music/iTunes/iTunes Media/Music/Edward Sharpe \u0026 The Magnetic Zeros/Here Comes/02 Janglin.mp3\n\nYou can use a numeric argument to specify the number of tracks to skip ahead,\nlike `dhun prev 2`.\n\nShuffling the queue\n\n    $ dhun shuffle\n    Queue is shuffled\n    Queue:\n    1 : Deadmau5 - I Remember (Vocal Mix)\n    2 : Paul van Dyk - Haunted\n    3 : Above \u0026 Beyond - I Am What I Am\n    4 : Above \u0026 Beyond - Sirens Of The Sea\n    5 : Paul van Dyk - Haunted\n\n### Other commands\n\nStatus\n\n    $ dhun status\n    Dhun is running\n    Currently Playing:\n    Deadmau5 - I Remember (Vocal Mix)\n    Queue:\n    1 : Paul van Dyk - Haunted\n    2 : Above \u0026 Beyond - I Am What I Am\n    3 : Above \u0026 Beyond - Sirens Of The Sea\n    \nHistory\n\n    $ dhun history\n    1 files in history\n    History:\n    1 : Deadmau5 - I Remember Feat Kaskade (Instrumental Mix)\n    \nSaving Playlist\n\n    $ dhun save_playlist /tmp/playlist.pls\n    created /tmp/playlist.plsg\n    \nLoading Playlist\n\n    $ dhun load_playlist /tmp/playlist.pls\n    14 files queued\n    loaded playlist\n\n\n### Stopping Dhun\n\nThis will exit the dhun server.\n\n    $ dhun stop_server\n\n## New Features\n\nPlease file an issue with a feature request, if you have one.\n\nThese things are planned someday:\n\n* iTunes integration\n\n## Feedback\n\nemail me at deepak DOT jois AT gmail DOT com","funding_links":[],"categories":["Ruby"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepakjois%2Fdhun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeepakjois%2Fdhun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepakjois%2Fdhun/lists"}