{"id":21680838,"url":"https://github.com/brunobord/relax","last_synced_at":"2025-06-21T09:37:17.750Z","repository":{"id":13768563,"uuid":"16463437","full_name":"brunobord/relax","owner":"brunobord","description":"Free clone of noisli.com - a multiple-file markdown editor, ambient sounds and uncluttered interface","archived":false,"fork":false,"pushed_at":"2021-04-17T06:27:38.000Z","size":34138,"stargazers_count":163,"open_issues_count":8,"forks_count":39,"subscribers_count":8,"default_branch":"gh-pages","last_synced_at":"2025-04-06T02:34:49.522Z","etag":null,"topics":["ambiance","distractionless","editor","sound","webapp","wtfpl"],"latest_commit_sha":null,"homepage":"https://brunobord.github.io/relax/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brunobord.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-02-02T21:17:19.000Z","updated_at":"2025-03-29T19:14:45.000Z","dependencies_parsed_at":"2022-08-31T03:40:41.602Z","dependency_job_id":null,"html_url":"https://github.com/brunobord/relax","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/brunobord/relax","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brunobord%2Frelax","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brunobord%2Frelax/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brunobord%2Frelax/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brunobord%2Frelax/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brunobord","download_url":"https://codeload.github.com/brunobord/relax/tar.gz/refs/heads/gh-pages","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brunobord%2Frelax/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259737917,"owners_count":22903872,"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":["ambiance","distractionless","editor","sound","webapp","wtfpl"],"created_at":"2024-11-25T15:21:27.437Z","updated_at":"2025-06-14T00:04:38.496Z","avatar_url":"https://github.com/brunobord.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Relax\n\nRelax is a Free (as in speech and beer) clone of [Noisli](https://noisli.com).\n\nTo use it, you have several options:\n\n* Go to [the associated Github page](http://brunobord.github.io/relax/) for this project.\n* put these files and static resources somewhere on a web server. It can be local or remote.\n\nBrowse the single ``index.html`` page using a modern browser.\n\n## Features\n\n* A markdown text-editor with syntax highlighting, preview, and a minimalistic styling toolbar,\n* The text is autosaved every 500ms and stored in the localStorage container,\n* You have many sounds available if you want to build a cool ambiance while you're writing (fireplace, wind in the leaves, seashore...),\n* Store and load files using the localStorage database,\n* Download the markdown file to your disk using the download icon.\n\n### Missing features\n\n(a.k.a. TODOs)\n\n* You can't adjust the sound level on the interface. The volume is set in the code. You can change it manually by editing the volume percentage *in the source code* and reload the page.\n* Should I put some LESS for the CSS customization? I'm not sure. Maybe. Help me out if you can.\n\n### Hacking on features\n\nIf you want to be able to produce the uglified/minified sources, you'll have to install the required dependencies like this:\n\n```shell\nnpm install\n```\n\nThe Makefile allows you to minify the js and the css files, using the following command:\n\n```shell\nmake minify\n```\n\nOr you may chose to minify the JS or the CSS files:\n\n```shell\nmake minify_js\nmake minify_css\n```\n\n## Why this project?\n\nLet me be as clear as possible: Noisli is an absolutely great concept, and it's carefully designed and suits many people's needs. But a few things were annoying me in Noisli:\n\n* You can only have one document handled by the editor, no \"save for later use\",\n* No syntax highlighting,\n* What's the point in the smoothly-changing background color? At some point, it's unreadable and unusable (white on yellow, really?),\n* White noise? Pink noise? Brown noise? Really?\n* Preview view is not different enough from the editor for my tastes. I needed a \"closer-to-the-html\" preview (sans-serif fonts, for example).\n* You can't use it if you're not connected to the Internet. If only I could have a copy of Noisli for local / offline use, that'd be great.\n\nAll these (minor) glitches have led me to grab my favorite text editor and build my custom clone of Noisli.\n\n## Note on privacy\n\nThe edited text in this interface is stored on your localStorage database.\n\nYou can check the source code, nothing is stored on the server. I will never **EVER** read your documents. It's all yours.\n\nIt also means this content is associated to the \"domain name\" you're on (whether it is github pages, your local static HTTP server, your own remote web server, etc) **AND** your web browser.\n\nIf you switch from a machine to another or if you swap from Firefox to Chrome or vice-versa, your content won't show up. And even if you're on the same machine/browser and use a different URL to access this interface, your localStorage database will be different. Use the \"download\" feature to safely copy your content from a machine to another and sync it your way if you intend to transfer it on another pair (URL / client).\n\n## License\n\nThis project uses:\n\n* [Editor.js, derived from this project](https://github.com/lepture/editor),\n  by Hsiaoming Yang.\n* [icomoon icons](https://icomoon.io/),\n* [Glyphicons icons](https://glyphicons.com/),\n* [Meteocons icons](http://www.alessioatzeni.com/meteocons/),\n* The other font icons are made using the great\n  [Fontello tool](http://fontello.com/), and come from Font Awesome, Entypo,\n  Typicons, Maki, Elusive,\n* [JQuery](https://jquery.com),\n* [JPlayer](http://jplayer.org/),\n* Fonts are [Ubuntu Mono](http://font.ubuntu.com/),\n  [Lato](http://www.latofonts.com/lato-free-fonts/),\n  [Roboto Slab](https://fonts.google.com/specimen/Roboto+Slab), provided by\n  [Google Webfonts](https://www.google.com/fonts/)\n* Responsive grid by the [.fitgrd project](http://www.fitgrd.com/)\n\n## Sounds:\n\n* [Rain in forest](https://www.freesound.org/people/inchadney/sounds/22132/) - by inchadney CC-BY,\n* [rbh thunder storm](https://www.freesound.org/people/RHumphries/sounds/2523/) (storm with rain) - by RHumphries, CC-BY,\n* [Storm](https://www.freesound.org/people/Erdie/sounds/23221/) by Erdie, CC-BY,\n* [SummerEveningInMyGarden](https://www.freesound.org/people/acclivity/sounds/30832/), by acclivity - CC-BY-NC,\n* [AMBIENT LOOP - Perfectly Clear - Wilderness Hillside - FILTERED](https://www.freesound.org/people/Arctura/sounds/39829/), by Arctura - CC-BY,\n* [Vent - wind(1)](https://www.freesound.org/people/Glaneur%20de%20sons/sounds/104952/) by Glaneur de sons - CC-BY,\n* [oceanwavescrushing.wav](https://www.freesound.org/people/Luftrum/sounds/48412/) by Luftrum - CC-BY,\n* [fireplace](https://www.freesound.org/people/martats/sounds/138018/) by martats - CC-0,\n* [131024_brook_black_forest.wav](https://www.freesound.org/people/reinsamba/sounds/204195/) by reinsamba - CC-BY,\n\nAll these sounds were suggested by [Jean-Michel Armand](https://github.com/mrjmad).\n\nApart from that, the rest of the code (HTML/CSS/JS) is mine and is published\nunder the terms of the [WTFPL](http://www.wtfpl.net/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrunobord%2Frelax","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrunobord%2Frelax","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrunobord%2Frelax/lists"}