{"id":13850175,"url":"https://github.com/xvw/qian","last_synced_at":"2026-03-08T17:38:39.169Z","repository":{"id":79521515,"uuid":"109787883","full_name":"xvw/qian","owner":"xvw","description":"A minimalist file-explorer using Electron via Elm.","archived":false,"fork":false,"pushed_at":"2019-04-03T04:57:51.000Z","size":1526,"stargazers_count":205,"open_issues_count":1,"forks_count":8,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-07T02:36:57.879Z","etag":null,"topics":["electron","elm","explorer","finder","micro"],"latest_commit_sha":null,"homepage":"","language":"Elm","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/xvw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-11-07T04:44:34.000Z","updated_at":"2024-11-01T17:21:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"c8e74a46-c8dc-40c2-b2ea-816dc4da4c37","html_url":"https://github.com/xvw/qian","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvw%2Fqian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvw%2Fqian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvw%2Fqian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvw%2Fqian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xvw","download_url":"https://codeload.github.com/xvw/qian/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248162928,"owners_count":21057838,"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":["electron","elm","explorer","finder","micro"],"created_at":"2024-08-04T20:01:00.656Z","updated_at":"2026-03-08T17:38:39.133Z","avatar_url":"https://github.com/xvw.png","language":"Elm","funding_links":[],"categories":["Elm"],"sub_categories":[],"readme":"# Qian (wip)\n\n\u003e Qian is an hackable **micro File explorer** for **OSX**, written in **Elm** and\n\u003e **Electron**. The name **Qian** come from the name of\n\u003e [Zhang Qian](https://en.wikipedia.org/wiki/Zhang_Qian), a Chinese\n\u003e explorer. (aha get it ?)\n\n\n## Tl;dr\n\n![Sample](branding/qian2.gif)\n\n\n\nSince I'm on Mac, I mainly use the terminal to navigate my files because\nI do not like much Finder (I don't really have any arguments ...).\nSo I decided to build a small file explorer (mainly to navigate my documents)\nthat would fit perfectly to **my needs**.\n\nI used **Elm** because I wanted to learn how to use it, and **Electron**\nbecause I want to prototype quickly.\n\n## Philosophy\n\nThe main goal of this project is not to create a revolutionary software.\nJust build a useful software for me. The idea is to implement features only\n**when I need them**.\n\nIf you see any changes to the code, do not hesitate to make an issue or pull-request!\nIn addition, if a feature seems interesting to implement, let's talk about it in an issue!\n\n## Usage\n\n-  `npm install -g elm` (to install Elm)\n-  `make install` to fetch the NPM dependancies\n-  `make build` to build the application\n-  `make run` to run the buildt application\n-  `make` (a combo of `make build` and `make run`)\n-  `make app` to create a runnable app on OSX\n\n## Shortcuts\n\n-  `Tab` : toggle the focus on the searchbar\n-  `Cmd + Alt + Enter` : Open the current folder in finder\n-  `Cmd + Enter` : Open the current folder in a terminal\n-  `Cmd + \u003c` : Go on the pred view (if it exists)\n-  `Cmd + \u003e` : Go on the next view (if it exists)\n-  `Cmd + Shift + Space` : Go to the parent (if it exists)\n\n## About the search bar\n\nUsing `Tab` you can toggle the search-bar activation. When you write\ntext into this bar, the content of the folder will be filtered using\na fuzzy-filtering. If you write `/`, Qian will open the first element\nof the result of the filtering.\n\n\n## Credits\n\n-  [@radmen](https://github.com/radmen): add the support of Fuzzy-Search (using\n   a NoRedink's package)\n-  [@julien-leclercq](https://github.com/julien-leclercq): Makefile improvement\n-  [@xvw](https://github.com/xvw): everything else... (I think :P)\n\n### Tools\n\n-  [Dotgrid](http://wiki.xxiivv.com/#dotgrid) (for the logo)\n-  [Elm](http://elm-lang.org/) (to have a nice language)\n-  [Electron](https://electron.atom.io/) (to have a window !)\n-  [Font Awesome](http://fontawesome.io/) (for the icon in the UI)\n-  [NoRedInk Simple Fuzzy](http://package.elm-lang.org/packages/NoRedInk/elm-simple-fuzzy/latest)\n   (for the Fuzzy Searching)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxvw%2Fqian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxvw%2Fqian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxvw%2Fqian/lists"}