{"id":30859211,"url":"https://github.com/mguinada/vlc-client","last_synced_at":"2026-03-09T05:31:36.342Z","repository":{"id":5008386,"uuid":"6166760","full_name":"mguinada/vlc-client","owner":"mguinada","description":"vlc-client allows to control VLC media player over TCP","archived":false,"fork":false,"pushed_at":"2022-01-06T02:12:20.000Z","size":122,"stargazers_count":26,"open_issues_count":1,"forks_count":20,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-12-06T07:48:58.507Z","etag":null,"topics":["client","ruby","vlc-media-player"],"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/mguinada.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-10-11T00:52:56.000Z","updated_at":"2025-04-02T15:26:01.000Z","dependencies_parsed_at":"2022-08-30T10:50:53.449Z","dependency_job_id":null,"html_url":"https://github.com/mguinada/vlc-client","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/mguinada/vlc-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mguinada%2Fvlc-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mguinada%2Fvlc-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mguinada%2Fvlc-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mguinada%2Fvlc-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mguinada","download_url":"https://codeload.github.com/mguinada/vlc-client/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mguinada%2Fvlc-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30283893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T02:57:19.223Z","status":"ssl_error","status_checked_at":"2026-03-09T02:56:26.373Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["client","ruby","vlc-media-player"],"created_at":"2025-09-07T14:57:32.411Z","updated_at":"2026-03-09T05:31:36.311Z","avatar_url":"https://github.com/mguinada.png","language":"Ruby","readme":"# vlc-client [![Build Status](https://secure.travis-ci.org/mguinada/vlc-client.png?branch=master)](http://travis-ci.org/mguinada/vlc-client)\n\nvlc-client manages a [VLC media player](http://www.videolan.org/vlc/) instance through its RC interface.\n\n### Installation\n\nAdd this line to your application's Gemfile:\n\n    gem 'vlc-client'\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install vlc-client\n\n### Usage\n\n##### Create a client and connect to a running VLC media player instance.\n\n```ruby\n\nvlc = VLC::Client.new('192.168.1.10', 9999) #Expects a VLC media player running on `192.168.1.10:9999`, e.g. `vlc --extraintf rc --rc-host 192.168.1.10:9999`\n\nvlc.connect # connect to server\n# =\u003e true\n\nvlc.play('http://example.org/media.mp3') # play media\n# =\u003e true\n\nvlc.playing?\n# =\u003e true\n\nvlc.fullscreen\n# =\u003e true\n#...\n\n```\n\n##### Create a self managed client/server system.\nIf you need a local client/server VLC media player system\n\n\n```ruby\n\nvlc = VLC::System.new # A client/server system over a local managed VLC instance\n\nvlc.connected? # auto connect\n# =\u003e true\n\nvlc.play('http://example.org/media.mp3')\n# =\u003e true\n\nvlc.progress\n# =\u003e 1 #%\n#...\n\n# Technically this is the same as\nvlc = VLC::Client.new(VLC::Server.new('localhost', 9595, false))\n```\n\n# Playlist management\n\n```ruby\n\nvlc = VLC::System.new\n\nvlc.add_to_playlist('track1.mp3')\nvlc.add_to_playlist('track2.mp3')\n\nvlc.play\n\nvlc.playlist\n#=\u003e [{:number=\u003e1, :title=\u003e\"Track #1 title\", :length=\u003e\"00:03:10\", :times_played=\u003e1}, {:number=\u003e2, :title=\u003e\"Track #2 title\", :length=\u003e\"00:03:30\", :times_played=\u003e0}]\n\n```\n\n### Reference\n\n[reference](http://rdoc.info/github/mguinada/vlc-client)\n\n### Notice\n\nvlc-client has been tested on linux but it should work on any VLC installation as long as the command line is responsive for `vlc` and `cvlc` calls. On Mac OS X these are not available by default. They can be created with:\n\n```bash\necho \"alias vlc='/Applications/VLC.app/Contents/MacOS/VLC'\" \u003e\u003e ~/.bash_profile\necho \"alias cvlc='/Applications/VLC.app/Contents/MacOS/VLC'\" \u003e\u003e ~/.bash_profile\n```\n\n### Contributing\n\n1. Fork it\n2. Create your topic branch (`git checkout -b my-topic-branch`)\n3. Add/change specs for your unimplemented feature or bug fix\n4. Hack it\n5. Make sure specs pass (`bundle exec rake spec`)\n6. Edit the documentation in coherence with your feature or fixes. Run `bundle exec rake yard` to review\n7. Commit changes (`git commit -am 'Add some feature/fix'`) and push to the branch (`git push origin my-topic-branch`)\n8. Submit a pull request\n\n### Copyright\n\nCopyright (c) 2012 Miguel Guinada\n[LICENSE][] for details.\n\n[license]: https://github.com/mguinada/vlc-client/blob/master/LICENSE","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmguinada%2Fvlc-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmguinada%2Fvlc-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmguinada%2Fvlc-client/lists"}