{"id":37100438,"url":"https://github.com/pingf/annie","last_synced_at":"2026-01-14T12:14:06.575Z","repository":{"id":65771129,"uuid":"126013862","full_name":"pingf/annie","owner":"pingf","description":"👾 A fast, simple and clean video downloader","archived":false,"fork":true,"pushed_at":"2018-03-20T08:53:02.000Z","size":1414,"stargazers_count":16,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-06-20T01:56:25.101Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"iawia002/lux","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pingf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-03-20T12:27:11.000Z","updated_at":"2024-04-08T13:30:57.000Z","dependencies_parsed_at":"2023-02-09T03:30:29.166Z","dependency_job_id":null,"html_url":"https://github.com/pingf/annie","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/pingf/annie","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pingf%2Fannie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pingf%2Fannie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pingf%2Fannie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pingf%2Fannie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pingf","download_url":"https://codeload.github.com/pingf/annie/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pingf%2Fannie/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28419731,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T10:47:48.104Z","status":"ssl_error","status_checked_at":"2026-01-14T10:46:19.031Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":[],"created_at":"2026-01-14T12:14:05.731Z","updated_at":"2026-01-14T12:14:06.534Z","avatar_url":"https://github.com/pingf.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Annie\n\n[![Build Status](https://travis-ci.org/iawia002/annie.svg?branch=master)](https://travis-ci.org/iawia002/annie)\n[![codecov](https://codecov.io/gh/iawia002/annie/branch/master/graph/badge.svg)](https://codecov.io/gh/iawia002/annie)\n\n👾 A fast, simple and clean video downloader built with Go.\n\n```console\n$ annie -c cookies.txt https://www.bilibili.com/video/av20203945/\n\n   Site:    哔哩哔哩 bilibili.com\n  Title:    【2018拜年祭单品】相遇day by day\n   Type:    video\nQuality:    高清 1080P60\n   Size:    220.65 MiB (231363071 Bytes)\n\n 2.06 MiB / 220.65 MiB [\u003e-----------------------------]   0.93% 1.94 MiB/s 1m52s\n```\n\n## Install\n\n### Prerequisites\n\nThe following dependencies are required and must be installed separately.\n\n* **[FFmpeg](https://www.ffmpeg.org)**\n\n\u003e **Note**: FFmpeg does not affect the download, only affect the final file merge.\n\nTo install Annie, please use `go get`, or download the binary file in the [Releases](https://github.com/iawia002/annie/releases) page, or compile yourself.\n\n```bash\n$ go get github.com/iawia002/annie\n...\n$ annie [args] URL\n```\n\n\n## Get Started\n\n### Download a video\n\n```console\n$ annie https://www.douyin.com/share/video/6509219899754155272\n\n Site:    抖音 douyin.com\nTitle:    好冷  逢考必过\n Type:    mp4\n Size:    2.63 MiB (2762719 Bytes)\n\n 741.70 KiB / 2.63 MiB [=========\u003e--------------------------]  27.49% 1.98 MiB/s\n```\n\nYou can also use the `-i` option to view video information, skip download.\n\n\u003e Note: if you have special characters in your URL, we recommend putting URL in quotation marks. (thanks @tonyxyl for pointing this out)\n\u003e \n\u003e `$ annie 'https://...'`\n\n### Download anything else\n\nIf you already got the URL of the exact resource you want, you can download it directly:\n\n```console\n$ annie https://img9.bcyimg.com/drawer/15294/post/1799t/1f5a87801a0711e898b12b640777720f.jpg\n\nannie doesn't support this URL by now, but it will try to download it directly\n\n Site:    Universal\nTitle:    1f5a87801a0711e898b12b640777720f\n Type:    image/jpeg\n Size:    1.00 MiB (1051042 Bytes)\n\n 1.00 MiB / 1.00 MiB [===================================] 100.00% 3.35 MiB/s 0s\n```\n\n### Download playlist\n\nYou can use the `-p` option to tell Annie to download the whole playlist rather than a single video.\n\n```console\n$ annie -i -p https://www.bilibili.com/bangumi/play/ep198061\n\n Site:    哔哩哔哩 bilibili.com\nTitle:    Doctor X 第四季：第一集\n Type:    video\n Size:    845.66 MiB (886738354 Bytes)\n\n\n Site:    哔哩哔哩 bilibili.com\nTitle:    Doctor X 第四季：第二集\n Type:    video\n Size:    930.71 MiB (975919195 Bytes)\n\n...\n```\n\n### Resume a download\n\nYou may use \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eC\u003c/kbd\u003e to interrupt a download.\n\nA temporary `.download` file is kept in the output directory. Next time you run `annie` with the same arguments, the download progress will resume from the last session.\n\n### Cookies\n\nIf you need to log in your account to access something (a private video or VIP only video), use the `-c` option to feed the browser cookies to `annie`.\n\n**Note:**\n\n* the formats of cookies as follow:\n\n```\nname=value; name2=value2; ...\n```\n\ncookies can be a string or a file.\n\n```console\n$ annie -c \"name=value; name2=value2\" https://www.bilibili.com/video/av20203945\n\n# or\n\n$ annie -c cookies.txt https://www.bilibili.com/video/av20203945\n```\n\n\n### Proxy\n#### HTTP proxy\nYou can specify an HTTP proxy via `-x` option:\n\n```console\n$ annie -x http://127.0.0.1:7777 -i https://www.youtube.com/watch?v=Gnbch2osEeo\n```\n\n#### SOCKS5 proxy\nYou can also use `-s` option to specify a SOCKS5 proxy:\n\n```console\n$ annie -s 127.0.0.1:1080 -i https://www.youtube.com/watch?v=Gnbch2osEeo\n```\n\n\n### Use specified Referrer\n\nYou can use the `-r` option to tell Annie to use the given Referrer to request.\n\n```console\n$ annie -r https://www.bilibili.com/video/av20383055/ http://cn-scnc1-dx.acgvideo.com/...\n\n...\n```\n\n### Debug Mode\n\nYou can use the `-d` option to see network request message.\n\n```console\n$ annie -i -d http://www.bilibili.com/video/av20088587\n\nURL: http://www.bilibili.com/video/av20088587\nMethod: GET\nHeaders: map[User-Agent:[Mozilla/5.0 (Windows NT 10.0; WOW64; rv:51.0) Gecko/20100101 Firefox/51.0] Accept:[text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8] Accept-Charset:[UTF-8,*;q=0.5] Accept-Encoding:[gzip,deflate,sdch] Accept-Language:[en-US,en;q=0.8] Referer:[http://www.bilibili.com/video/av20088587]]\nStatus Code: 200\n\nURL: https://interface.bilibili.com/v2/playurl?appkey=84956560bc028eb7\u0026cid=32782944\u0026otype=json\u0026quality=0\u0026type=\u0026sign=708701ffaea9937d4541d5cc2f1cf3b1\nMethod: GET\nHeaders: map[Accept:[text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8] Accept-Charset:[UTF-8,*;q=0.5] Accept-Encoding:[gzip,deflate,sdch] Accept-Language:[en-US,en;q=0.8] User-Agent:[Mozilla/5.0 (Windows NT 10.0; WOW64; rv:51.0) Gecko/20100101 Firefox/51.0] Referer:[https://interface.bilibili.com/v2/playurl?appkey=84956560bc028eb7\u0026cid=32782944\u0026otype=json\u0026quality=0\u0026type=\u0026sign=708701ffaea9937d4541d5cc2f1cf3b1]]\nStatus Code: 200\n\n Site:    哔哩哔哩 bilibili.com\nTitle:    燃油动力的遥控奥迪R8跑赛道\n Type:    flv\n Size:    64.38 MiB (67504795 Bytes)\n```\n\n### All available arguments\n\n```console\n$ annie -h\n\nUsage of annie:\n  -c string\n    \tCookie\n  -d\tDebug mode\n  -i\tInformation only\n  -p\tDownload playlist\n  -r string\n    \tUse specified Referrer\n  -s string\n    \tSOCKS5 proxy\n  -v\tShow version\n  -x string\n    \tHTTP proxy\n```\n\n\n## Supported Sites\n\nSite | URL | 🎬 Videos | 🌁 Images | 📚 Playlist\n--- | --- | ---------| -------- | ---------\n抖音 | \u003chttps://www.douyin.com\u003e | ✓ | | |\n哔哩哔哩 | \u003chttps://www.bilibili.com\u003e | ✓ | | ✓ |\n半次元 | \u003chttps://bcy.net\u003e | | ✓ | |\npixivision | \u003chttps://www.pixivision.net\u003e | | ✓ | |\n优酷 | \u003chttps://www.youku.com\u003e | ✓ | | |\nYouTube | \u003chttps://www.youtube.com\u003e | ✓ | | |\n爱奇艺 | \u003chttps://www.iqiyi.com\u003e | ✓ | | |\n芒果TV | \u003chttps://www.mgtv.com\u003e | ✓ | | |\nTumblr | \u003chttps://www.tumblr.com\u003e | ✓ | ✓ | |\nVimeo | \u003chttps://vimeo.com\u003e | ✓ | | |\n\n\n## Contributing\nAnnie is an open source project and welcome contributions 😉\n\nCheck out the [CONTRIBUTING](https://github.com/iawia002/annie/blob/master/CONTRIBUTING.md) guide to get started\n\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpingf%2Fannie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpingf%2Fannie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpingf%2Fannie/lists"}