{"id":16985772,"url":"https://github.com/r4gus/studimanager","last_synced_at":"2026-05-15T20:33:29.461Z","repository":{"id":118776224,"uuid":"196635337","full_name":"r4gus/studimanager","owner":"r4gus","description":"A productivity tool aimed at students.","archived":false,"fork":false,"pushed_at":"2019-11-13T22:56:54.000Z","size":723,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-22T01:30:32.897Z","etag":null,"topics":["jackson","java","javafx","productivity-tool","timetable","university"],"latest_commit_sha":null,"homepage":"","language":"Java","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/r4gus.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-07-12T19:34:44.000Z","updated_at":"2019-11-13T22:56:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"adb106c5-4556-47d4-a876-88db87fdbaef","html_url":"https://github.com/r4gus/studimanager","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/r4gus/studimanager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r4gus%2Fstudimanager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r4gus%2Fstudimanager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r4gus%2Fstudimanager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r4gus%2Fstudimanager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/r4gus","download_url":"https://codeload.github.com/r4gus/studimanager/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r4gus%2Fstudimanager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33078899,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T20:25:35.270Z","status":"ssl_error","status_checked_at":"2026-05-15T20:25:34.732Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["jackson","java","javafx","productivity-tool","timetable","university"],"created_at":"2024-10-14T02:44:09.709Z","updated_at":"2026-05-15T20:33:29.444Z","avatar_url":"https://github.com/r4gus.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Studimanager\n\nA Course-Schedule/ productivity application written in Java. Keep track of your lessons with the built in weekly\ncalendar and manage your tasks with a fully customizable Kanban-board.\n\n## Getting Started\n\nThese instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.\n\n\n\n### Prerequisites\n\nWhat things you need to install the software and how to install them\n\n1. Java version 11 or newer\n2. JavaFx 11.0.1 (stable) or newer\n3. Jackson library\n4. controlsfx\n\n##### 1. Java version 11.04 or later recommended\n\nUnder Ubuntu:\nUse the following commands to install Open JDK\n```\n$ sudo apt update \u0026\u0026 sudo apt upgrade\n$ sudo apt install default-jdk\n$ java --version\n```\nIf you wan't to install Oracle JDK 11 follow the below commands\n```\n$ sudo add-apt-repository ppa:linuxuprising/java\n$ sudo apt update\n$ sudo apt install oracle-java11-installer\n```\n\n---\n\n##### 2. This application uses OpenJFX\nDownload the appropriate version [here](https://gluonhq.com/products/javafx/).\n\n---\n\n##### 3. Jackson library\nVisit [maven.org](https://search.maven.org/search?q=jackson-core), search for\n**jackson-core** and download: __jackson-core__, __jackson-databind__ and\n__jackson-annotations__ ( Group ID must be: **com.fasterxml.jackson.core**).\n\n---\n\n##### 4. Add controlsfx-11.0.0\nDownload __controlsfx-11.0.0__ from [here](https://github.com/controlsfx/controlsfx) and add it to the existing\nlibraries under __File -\u003e Project Structure -\u003e Libraries__.\n\n\n### Installing\n\nA step by step series of examples that tell you how to get a development env running\n\n##### IntelliJ\nOpen Intellij and create a new project:\n```\nNew Project -\u003e Project from Version Controll -\u003e Git -\u003e enter URL: https://github.com/r4gus/studimanager -\u003e clone\n```\n\n###### 1. Add the required libraries\nIn the newly created project go to: __File -\u003e Project Structure -\u003e Libraries -\u003e + -\u003e java__\nand enter:\n\n```\n/path/to/javafx-sdk-12.0.1/lib\n```\n\nAlso add the following libraries the same way:\n\n```\n/path/to/jackson/jackson-annotations-2.10.0.pr1.jar\n/path/to/jackson/jackson-core-2.10.0.pr1.jar\n/path/to/jackson/jackson-databind-2.10.0.pr1.jar\n```\n\n---\n\n###### 2. Add VM options (Required for JavaFx)\nGo to __Run -\u003e Edit Configurations -\u003e Application -\u003e Main__ and add the following to the __VM__ options:\n\n__Linux/ Mac__\n```\n--module-path /path/to/javafx-sdk-12.0.1/lib --add-modules javafx.controls,javafx.fxml\n```\n\n__Windows__\n```\n--module-path \"\\path\\to\\javafx-sdk-12.0.2\\lib\" --add-modules javafx.controls,javafx.fxml\n```\n\n---\n\n###### 3. Add Junit 5\n\nJust let Intellij import Junit for you.\n\n\n\n\n## Running the tests\n\n##### IntelliJ\nEvery major Package should have an __mypackage.test__ folder.\n\nFollow these instructions to run the automated tests:\n```\nRight Click on test -\u003e Run Tests in 'mypackage.test'\n```\n\n## Internationalization\nThis program supports multiple languages through __property__ files. All files can be found at __src.config.i18n.Resource\nBundle'TimetableResourceBundle'__. To add support for a new language follow these steps:\n\n1. Copy and rename an existing file. The naming convention is __TimetableResourceBundle_xx_XX.properties__.\nFor example, to support Italian name the file: ```TimetableResourceBundle_it_IT.properties```\n2. Translate all values of the key-value pairs depending on the language.\n3. Add the __language-code__ to   ```src.config.Language```\n4. Add a new case to the switch statement in ```Main.Main``` and don't forget the ```break```\n\n### Example\n\nThe program should support Italian:\n#### 1. Copy and rename an existing file:\n```\nTimetableResourceBundle_it_IT.porperties\n```\n\n#### 2. Translate values into Italian\n```\nTrue=true -\u003e True=vera\n...\n```\n\n#### 3. Add IT to src.config.Language\n```\npublic enum Language {\n    EN, DE, FR, IT\n}\n```\n\n#### 4. Add new case to the switch statement in Main\n```\nbundle = ResourceBundle.getBundle(\"config.i18n.TimetableResourceBundle\", new Locale(\"it\", \"IT\"));\nbreak;\n```\n\n## Deployment\n\n### 1. Create a .jar file from the project\n#### IntelliJ:\nFirst create an artifact under **File, Project Structure, Artifacts, add, jar, from Modules with dependency** and select\n**Main.Launcher** as the main class. After that add a copy of the javafx-sdk directory (**File, Poject Structure,\n Artifacts, Add Copy Of, Directory Content, path/to/javafx-sdk-12.0.1**). Finally build the artifact with (**Build,\n Build Artifact, studimanager, build/ rebuild**).\n \n#### Others:\ncoming soon...\n\n### 2. Add the required folders\nCreate a project folder and move the .jar file into it. Within the newly created folder add the following sub\ndirectories:\n\n1. resources (should contain: icons8-cancel-48.png, icons8-info-48.png and icons8-ok-48.png)\n2. log (contains the log files later on)\n3. files \n4. config (has to contain: user.properties and verbose.properties)\n\n### 3. Run the program\nRun the program with:\n```\njava -jar \u003cprogram_name\u003e.jar\n```\n\n### Errors\nJava 11 and later may not contain specific libraries required for JavaFx. If that's the case you should get an\nerror like: **...No suitable pipeline found...** or **...glass library missing...**.\n\nIf you can't find a proper Java version to run the application, the only way to fix this issue is to obtain \nthe required libraries and add them to Java.\n\n#### Missing libraries may be:\n##### under Linux (add them to java-sdk/lib)\nlibprism_es2.os, libprism_sw.so, libglass.so, libglassgtk3.so, libglassgtk2.so, libjavafx_font.so,\nlibjavafx_font_freetype.so, libjavafx_font_pango.so\n\n##### under Windows (add them to java-sdk\\bin)\nprism_d3d.dll, prism_sw.dll, javafx_font.dll, glass.dll\n\nIf you're using IntelliJ ultimate, you should get those libraries from the java version that ships with the IDE\nor just use that java version in the first place.\n\n\n## Built With\n\n* [JavaFx 12](https://rometools.github.io/rome/) - Used to build the GUI\n* [Jackson](https://github.com/FasterXML/jackson) - Used for data processing\n\n## Contributing\n\nUnder development.\n\n## Versioning\n\n\n## Authors\n\n* **David Sugar** - *Initial work* - [r4gus](https://github.com/r4gus)\n* **Lukas Mendel** - *Initial work* - [LukasMendel](https://github.com/LukasMendel)\n\n## License\n\n\n## Acknowledgments\n* Big __thanks__ to the coffee machine that keeps me going (r4gus)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr4gus%2Fstudimanager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fr4gus%2Fstudimanager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr4gus%2Fstudimanager/lists"}