{"id":22160251,"url":"https://github.com/silencesys/dh--spring","last_synced_at":"2025-03-24T15:21:43.135Z","repository":{"id":87418116,"uuid":"338333192","full_name":"silencesys/dh--spring","owner":"silencesys","description":"View XSLX files and \u2029create charts with\u2029 one click.","archived":false,"fork":false,"pushed_at":"2024-01-24T14:03:33.000Z","size":8345,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-29T20:27:39.941Z","etag":null,"topics":["chart","electron","javascript","vue","vuejs","xslx"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/silencesys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-02-12T13:54:31.000Z","updated_at":"2021-11-10T10:29:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"c1aebc96-51a1-4b38-8476-6a21257cbd7c","html_url":"https://github.com/silencesys/dh--spring","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silencesys%2Fdh--spring","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silencesys%2Fdh--spring/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silencesys%2Fdh--spring/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silencesys%2Fdh--spring/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/silencesys","download_url":"https://codeload.github.com/silencesys/dh--spring/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245294718,"owners_count":20591909,"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":["chart","electron","javascript","vue","vuejs","xslx"],"created_at":"2024-12-02T04:07:02.697Z","updated_at":"2025-03-24T15:21:43.114Z","avatar_url":"https://github.com/silencesys.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Spring windows](./cover.png)\n\n\u003ccenter\u003e\n\nSpring is an Electron made excel file viewer. It allows you to view your `.xslx` files, filter visible rows and easily preview a variety of graphs with one simple click. The app was developed by Martin Roček for a project by Josef Vacek, who also provided the funding for the development of this app.\n\n\u003c/center\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n# What is suported and what is not?\nAt the moment the app allows only single work-sheet `.xlsx` files. It can process as much as 2000 rows without any noticeable lags. I've also tested even larger data files with success. It expects that the first row in your `.xslx` file will be the table header.\n\n\u003cbr\u003e\n\n# Installation\nDownload the right package for your OS in the [releases](https://github.com/silencesys/spring/releases) section and simply extract the app or follow the installation instructions. Builds for MacOS are signed and thus the installation should be without any problem. Sadly, that can not be said about Windows builds, as I'm not a Windows developer, builds are not signed and thus you'll be prompted with a SmartScreen warning - you can safely proceed, or compare SHA which is present at each\ndownload tag.\n\n\u003cbr\u003e\n\n# How to use Spring\n\nFirst of all you need to open `.xslx` file, which can be done from the context menu or by clicking on the rounded folder button at the right side of the app window.\n\n## Configuration of the app\n\n### File settings\nThe configuration is divided into two sections. First is document based and can be set for each opened document differently. The first settings is a multi-value column which defines columns that might contain one or more values. From the app:\n\n\u003e These columns with more than one value should be marked by the prefix #: in the source file. Example: 1: value. Using a multi-value column allows you to connect multiple values in one row. Example: if you have two people in one column - 1: person; 2:person, you can assign another value from the same row, for example colour of clothes - 1: red; 2: blue. The graph automatically differentiates the values and shows person 1 as wearing red, person 2 as wearing blue. It isn't necessary to fill in both values, for example only person 1 is wearing red, while person 2 isn't described.\n\nThus you can mark some of the columns in your document as multi-valued if your columns contain more than one value or should be merged with other columns in the same row. The next option is to set data type for some of the columns. At the moment only\n`date` is supported and it allows you to see data on the timeline in the bar chart section.\n\n### Application settings\nThere are the standard settings as theme or localization, and there is also the option to allow filter sharing from the document section to the chart section. This helps you see charts for the part of the data that interests you the most.\n\n## Document section\n\nUpon opening the file, you should see a table with all the rows from your file. In the upper part of the content window is a filter field, where you can set filters which are applied on the rows. To create a filter, you need to type a term in to the search field - it is recommended to write a single word or part of a word, phrases are not supported in this version. Simple workaround for phrases is to use comma to separate each word in search. Then you choose one of the columns in your document and decide whether the filter should be `extending` or `specifying`.\n\n- **Extending filters** will include every row that meets at least one condition of all the set filters.\n- **Specifying filters** will include only those rows that met all the conditions of all the set filters.\n\nAfter this, hit the button **create filter** and it will be automatically applied on all the rows in the document. Thus if your document exceeds the limitation of the renderer, which is 500 rows, and only 100 rows from the whole document meets the filter criteria, all these rows will be shown.\n\n## Chart section\nIn the chart section it is possible to preview charts with a few clicks. The app supports only the **pie** and **column** charts at the moment. In the pie chart you can combine different views for two chosen columns. The same applies to the column charts with a few important differences. Column charta support the frequency column which allows you to see the frequency of a phenomena. The other difference is the possibility to see the chosen phenomena on a timeline if you set the `date` data type on some of the columns in the settings. In case you have too many values (shown as tags) in the bar chart, there is a xsmall arrow in the right corner which can be draged to make the field with values (tags) smaller.\n\nEvery chart can be easily exported with one simple click. The export button is located near the rounded open button at the top of the application.\n\n\u003cbr\u003e\n\n# Development\nThe app uses [Vue CLI Plugin Electron Builder](https://nklayman.github.io/vue-cli-plugin-electron-builder/) thus can be modified as any other JavaScript application.\n\n### Project setup\nFirst you need to clone this repository, then install dependencies via Node package manager.\n\n```bash\ngit clone https://github.com/silencesys/spring.git spring\ncd spring\nnpm install\n```\n\n### Compiles and hot-reloads for development\nAs this is a Vue.js project, you can use Webpack server within the Electron window by running command:\n```\nnpm run electron:serve\n```\n\n### Compiles and minifies for production\nWhen you're done with all changes, simply run following command to build the app. Builded app will be available in the `dist` directory.\n```\nnpm run electron:build\n```\n\n\u003cbr\u003e\n\n# Contributions\nAll contributions are welcomed, however give me some time to review your requests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsilencesys%2Fdh--spring","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsilencesys%2Fdh--spring","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsilencesys%2Fdh--spring/lists"}