{"id":13425044,"url":"https://github.com/schollz/cowyo","last_synced_at":"2025-05-16T16:09:52.845Z","repository":{"id":3878682,"uuid":"51203449","full_name":"schollz/cowyo","owner":"schollz","description":"A feature-rich wiki webserver for minimalists :cow: :speech_balloon:","archived":false,"fork":false,"pushed_at":"2023-07-06T16:56:55.000Z","size":17137,"stargazers_count":936,"open_issues_count":38,"forks_count":68,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-04-12T15:57:24.885Z","etag":null,"topics":["encryption","minimalist","pastebin","server","wiki"],"latest_commit_sha":null,"homepage":"https://cowyo.com/","language":"JavaScript","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/schollz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":"schollz"}},"created_at":"2016-02-06T13:28:39.000Z","updated_at":"2025-04-01T21:08:20.000Z","dependencies_parsed_at":"2024-01-12T21:19:46.042Z","dependency_job_id":"dd931991-e17f-421e-84f0-5b5012c916ad","html_url":"https://github.com/schollz/cowyo","commit_stats":{"total_commits":514,"total_committers":13,"mean_commits":39.53846153846154,"dds":"0.15369649805447472","last_synced_commit":"a58f4ca346eb1d1ff8363250373c188b23ea3614"},"previous_names":["schollz/awwkoala"],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schollz%2Fcowyo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schollz%2Fcowyo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schollz%2Fcowyo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schollz%2Fcowyo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/schollz","download_url":"https://codeload.github.com/schollz/cowyo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254564127,"owners_count":22092122,"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":["encryption","minimalist","pastebin","server","wiki"],"created_at":"2024-07-31T00:01:03.152Z","updated_at":"2025-05-16T16:09:52.818Z","avatar_url":"https://github.com/schollz.png","language":"JavaScript","funding_links":["https://github.com/sponsors/schollz"],"categories":["Go","JavaScript","Install from Source","server","Wikis","Other"],"sub_categories":["Wikis","Localization"],"readme":"\n\u003cp align=\"center\"\u003e\n\u003cimg\n    src=\"/static/img/logo.png\"\n    width=\"260\" height=\"80\" border=\"0\" alt=\"linkcrawler\"\u003e\n\u003cbr\u003e\n\u003ca href=\"https://travis-ci.org/schollz/cowyo\"\u003e\u003cimg\nsrc=\"https://img.shields.io/travis/schollz/cowyo.svg?style=flat-square\"\nalt=\"Build Status\"\u003e\u003c/a\u003e \u003ca\nhref=\"https://github.com/schollz/cowyo/releases/latest\"\u003e\u003cimg\nsrc=\"https://img.shields.io/badge/version-2.11.0-brightgreen.svg?style=flat-square\"\nalt=\"Version\"\u003e\u003c/a\u003e \u003c/p\u003e\n\n\u003cp align=\"center\"\u003eA feature-rich wiki for minimalists\u003c/a\u003e\u003c/p\u003e\n\n*cowyo* is a self-contained wiki server that makes jotting notes easy and _fast_. The most important feature here is _simplicity_. Other features include versioning, page locking, self-destructing messages, encryption, and listifying. You can [download *cowyo* as a single executable](https://github.com/schollz/cowyo/releases/latest) or install it with Go. Try it out at https://cowyo.com.\n\nThere is now [a command-line tool, *cowyodel*](https://github.com/schollz/cowyodel) to interact with *cowyo* and transfer information between computers with only a code phrase: [schollz/cowyodel](https://github.com/schollz/cowyodel).\n\nGetting Started\n===============\n\n## Install\n\nIf you have go\n\n```\ngo get -u github.com/schollz/cowyo/...\n```\n\nor just [download the latest release](https://github.com/schollz/cowyo/releases/latest).\n\n## Run\n\nTo run just double click or from the command line:\n\n```\ncowyo\n```\n\nand it will start a server listening  on `0.0.0.0:8050`. To view it, just go to http://localhost:8050 (the server prints out the local IP for your info if you want to do LAN networking). You can change the port with `-port X`, and you can listen *only* on localhost using `-host localhost`.\n\n**Running with TLS**\n\nSpecify a matching pair of SSL Certificate and Key to run cowyo using https. *cowyo* will now run in a secure session. \n\n*N.B. Let's Encrypt is a CA that signs free and signed certificates.*\n\n```\ncowyo --cert \"/path/to/server.crt\" --key \"/p/t/server.key\"\n```\n\n**Running with Docker**\n\nYou can easily get started with Docker. First pull the latest image and create the volume with:\n\n```\ndocker run -d -v /directory/to/data:/data -p 8050:8050 schollz/cowyo\n```\n\nThen you can stop it with `docker stop cowyo` and start it again with `docker start cowyo`.\n\n## Server customization\n\nThere are a couple of command-line flags that you can use to make *cowyo* your own micro-CMS. \n\n```\ncowyo -lock 123 -default-page index.html -css mystyle.css -diary\n```\n\nThe `-lock` flag will automatically lock every page with the passphrase \"123\". Also, the default behavior will be to redirect `/` to `/index.html`. Also, every page that is published will automatically redirect to `/mypage/read` which will show the custom CSS file if it is supplied with `-css`. The `-diary` flag allows you to generate a time-stamped page instead of a random named page when you select \"New\".\n\n## Usage\n\n*cowyo* is straightforward to use. Here are some of the basic features:\n\n### Publishing \n\nIf you hover the the top left button (the name of the page) you will see the option \"Publish\". Publishing will add the page to the `sitemap.xml` for crawlers to find. It will also default that page to go to the `/read` route so it can be easily viewed as a single page.\n\n### View all the pages\n\nTo view the current list of all the pages goto to `/ls`.\n\n### Editing\n\nWhen you open a document you'll be directed to an alliterative animal (which is supposed to be easy to remember). You can write in Markdown. Saving is performed as soon as you stop writing. You can easily link pages using [[PageName]] as you edit.\n\n![Editing](http://i.imgur.com/vEs2U8z.gif)\n\n### History\n\nYou can easily see previous versions of your documents.\n\n![History](http://i.imgur.com/CxhRkyo.gif)\n\n### Lists\n\nYou can easily make lists and check them off.\n\n![Lists](http://i.imgur.com/7xbauy8.gif)\n\n### Locking\n\nLocking prevents other users from editing your pages without a passphrase.\n\n![Locking](http://i.imgur.com/xwUFV8b.gif)\n\n### Encryption\n\nEncryption is performed using AES-256.\n\n![Encryption](http://i.imgur.com/rWoqoLB.gif)\n\n### Self-destructing pages\n\nJust like in mission impossible.\n\n![Self-destructing](http://i.imgur.com/upMxFQh.gif)\n\n\n## Development\n\nYou can run the tests using\n\n```\n$ cd $GOPATH/src/github.com/schollz/cowyo\n$ go test ./...\n```\n\nAny contributions are welcome.\n\n## Thanks\n\n...to [DanielHeath](https://github.com/DanielHeath) who has introduced some stellar improvements into cowyo including supporting category pages, hot-template reloading, preventing out-of-order updates, added password access, fade-out on deleting list items, and image upload support!\n\n## License\n\nMIT\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschollz%2Fcowyo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fschollz%2Fcowyo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschollz%2Fcowyo/lists"}